Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

vswprintf(3C)

Name

vfwprintf, vwprintf, vswprintf, vfwprintf_s, vwprintf_s, vswprintf_s, vsnwprintf_s - wide-character formatted output of a stdarg argument list

Synopsis

#include <stdarg.h>
#include <stdio.h>
#include <wchar.h>

int vwprintf(const wchar_t *restrict format, va_list arg);
int vfwprintf(FILE *restrict stream, const wchar_t *restrict format,
     va_list arg);
int vswprintf(wchar_t *restrict s, size_t n,
     const wchar_t *restrict format, va_list arg);
#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <wchar.h>

int vwprintf_s(const wchar_t *restrict format, va_list arg);
int vfwprintf_s(FILE *restrict stream, const wchar_t *restrict format,
     va_list arg);
int vswprintf_s(wchar_t *restrict s, rsize_t n,
     const wchar_t *restrict format, va_list arg);
int vsnwprintf_s(wchar_t *restrict s, rsize_t n,
     const wchar_t *restrict format, va_list arg);

Description

The vwprintf(), vfwprintf(), vswprintf(), vwprintf_s(), vfwprintf_s(), vswprintf_s(), and vsnwprintf_s() functions are the same as wprintf(), fwprintf(), swprintf(), wprintf_s(), fwprintf_s(), swprintf_s(), and snwprintf_s() respectively, except that instead of being called with a variable number of arguments, they are called with an argument list as defined by <stdarg.h>.

These functions do not invoke the va_end() macro. However, as these functions do invoke the va_arg() macro, the value of ap after the return is indeterminate.

Return Values

Refer to fwprintf(3C).

Errors

Refer to fwprintf(3C).

Usage

Applications using these functions should call va_end(ap) afterward to clean up.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Standard

See Also

fwprintf(3C), setlocale(3C), attributes(7), standards(7), runtime_constraint_handler(3C)

History

See fwprintf(3C).