[ First ]  [ Previous ]  [ Next ]  [ Last ]  [ Manuals ]


vswprintf

Write a formatted output to a wide character string.

Compatibility:

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32


Prototype:
#include <stdio.h>
#include <wchar.h>
#include <stdarg.h>
int vswprintf(wchar_t * restrict s, size_t n,
  const wchar_t * restrict format, va_list arg);
Parameters:

Parameters for this function are:

s  
wchar_t*  
The string being read  
n  
size_t  
Number of char to print  
format  
wchar_t*  
The format string  
arg  
...  
Variable arguments  

Remarks:

The vswprintf() function works identically to the swprintf() function. Instead of the variable list of arguments that can be passed to swprintf(), vswprintf() accepts its arguments in the array arg of type va_list, which must have been initialized by the va_start() macro (and possibly subsequent va_arg calls) from the stdarg.h header file. The vfwprintf() function does not invoke the va_end macro.

Refer to the "wprintf" function for details of the format string.


NOTE

The vswprintf function does not invoke the va_end macro.
Return:

Returns the number of characters written not counting the terminating null wide character. Otherwise WEOF if failure occurs.

See Also:

"Wide Character and Byte Character Stream Orientation"

"swprintf"

"vsprintf"


[ First ]  [ Previous ]  [ Next ]  [ Last ]  [ Manuals ]

Visit the Metrowerks website at: http://www.metrowerks.com
For assistance contact Metrowerks Technical Support at: cw_support@metrowerks.com
Copyright © 2000, Metrowerks Corp. All rights reserved.

Last updated: August 16, 2000