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:

ANSI, POSIX 1003.1

Caveats:

It's safe to call this function in a signal handler if the data isn't floating point.

See also:

errno, fprintf(), fwprintf(), printf(), snprintf(), sprintf(), vfprintf(), vfwprintf(), vprintf(), vsnprintf(), vsprintf(), vswprintf(), vwprintf(), wprintf()