chsvlib
chsv helper source code

◆ sPrintfA()

int Chusov::String::sPrintfA ( char *restrict  pDest,
const char *restrict  pszFormat,
  ... 
)
noexcept

Loads the data from the given locations, converts it to multibyte string equivalents and writes the results to a string buffer.

Parameters
[out]pDestis a pointer to the output buffer where the converted string is to be written to. The size of the buffer is assumed to be enough to hold the string including the terminating zero. Use vscPrintfA function to acquire a length of the resulting string prior to the current call.
[in]pszFormatis a pointer to a zero terminated string defining how to interpret data, passed as additional parameters, during the construction of the output. See PrintfA for the definition of the format lexemes.
...constitute an optional set of additional parameters to build the formatted output according to pszFormat.
Returns
On success the function returns a number of bytes of the output not counting the terminating zero. If an error occurs the function returns a negative value.

The function implements the behaviour of the standard C sprintf function with full accordance to ISO/IEC 9899:1999 (aka C99) and ISO/IEC 9899:2011 (aka C11) with some standard-compatible extensions specific to the chsvlib library. See PrintfA for the details.

See also
PrintfA;
vPrintfW;
vPrintfA_s.