swprintf()
Print formatted wide-character output into a string
Synopsis:
#include <wchar.h> int swprintf( wchar_t * ws, size_t n, const wchar_t * format, ... );
Arguments:
- ws
- A pointer to the buffer where you want to function to store the formatted string.
- n
- The maximum number of wide characters to store in the buffer, including a terminating null character.
- format
- A wide-character string that specifies the format of the output. The formatting string determines what additional arguments you need to provide. For more information, see printf() .
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The swprintf() function is similar to fwprintf() except that swprintf() places the generated output into the wide-character array pointed to by buf, instead of writing it to a file. A null character is placed at the end of the generated character string.
The swprintf() function is the wide-character version of sprintf() .
Returns:
The number of wide characters written, excluding the terminating NUL, or a negative number if an error occurred (errno is set).
Classification:
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Read the Caveats |
Thread | Yes |
Caveats:
It's safe to call this function in a signal handler if the data isn't floating point.