Home / Autodocs / utility.library
NAME
- VSNPrintf
-
print formatted data, length limited (V47)
SYNOPSIS
length = VSNPrintf(buffer,bufsize,fmt,data)
D0 A0 D0 A1, A2
LONG VSNPrintf(UBYTE *buffer,ULONG bufsize,const UBYTE *fmt,APTR data);
LONG SNPrintf(UBYTE *buffer,ULONG bufsize,const UBYTE *fmt,...);
D0 A0 D0 A1, A2
LONG VSNPrintf(UBYTE *buffer,ULONG bufsize,const UBYTE *fmt,APTR data);
LONG SNPrintf(UBYTE *buffer,ULONG bufsize,const UBYTE *fmt,...);
FUNCTION
Prints formatted data using the format instructions of RawDoFmt() into a length-limited buffer, and returns the full number of characters (including NUL) that would have been written in total for an unlimited buffer size.
INPUTS
- buffer
-
buffer to write to, or NULL if only the size of the required buffer is to be determined
- bufsize
-
buffer size into which the output is to fit
- fmt
-
format string, using the formatting instructions of RawDoFmt(), see there for details
- data
-
data stream containing the source to be formatted
RESULT
- length
-
buffer size required for the output. This may be larger than the buffer
NOTES
The output is always NUL terminated if a buffer is supplied and its size is non-zero. The return code of this function indicates the size the output buffer must at least have to hold the full formatted output, INCLUDING the NUL byte. Note that this is different from the ANSI function which returns the (hypothetical) string size.
Starting with version 47.3, both the LVO and the argument register order of this function have been changed for compatibility reasons. Make sure to have a recent copy of the AmigaOS include files so that your applications use the correct API to call VSNPrintf().
Starting with version 47.3, both the LVO and the argument register order of this function have been changed for compatibility reasons. Make sure to have a recent copy of the AmigaOS include files so that your applications use the correct API to call VSNPrintf().
SEE ALSO
RawDoFmt()