chsvlib
chsv helper source code

◆ sPrintf_s()

int Chusov::String::sPrintf_s ( CHAR_TYPE *restrict  pDest,
rsize_t  cchDest,
const CHAR_TYPE *restrict  pszFormat,
  ... 
)
noexcept

Resolves to sPrintfA_s or to sPrintfW_s depending on the template parameter.

Template Parameters
CHAR_TYPEis a template parameter specifying a type of strings the template specialization is to work with. That is CHAR_TYPE=char for multibyte strings in the current locale or CHAR_TYPE=wchar_t for wide strings. The corresponding functions, wrapped over by the template specializations, are sPrintfA_s and sPrintfW_s.
Parameters
[out]pDestis a pointer to the output buffer where the converted string is to be written to.
[in]cchDestis a size of the output buffer, in characters, including the terminating zero.
[in]pszFormatis a pointer to a zero terminated string defining how to interpret data, passed as additional parameters, during the construction of the output.
...constitute an optional set of additional parameters to build the formatted output according to pszFormat.
Returns
On success the function returns a number of characters written to the buffer not counting the terminating zero. If an encoding error occurs the function returns a negative value. If any other runtime constraint violation occurred, the function returns 0.

See sPrintfA_s and sPrintfW_s for the details.