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


vfwprintf

Write a formatted text to a file stream.

Compatibility:

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32


Prototype:
#include <wchar.h>
int vfwprintf(FILE * file, 
  const wchar_t * format_str, va_list arg);
Parameters:

Parameters for this function are:

file  
FILE *  
The stream being written  
format_str  
wchar_t*  
The format string  
arg  
va_list  
A variable argument list  

Remarks:

The vfwprintf() function works identically to the fwprintf() function. Instead of the variable list of arguments that can be passed to fwprintf(), vfwprintf() 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

On embedded/ RTOS systems this function only is implemented for stdin, stdout and stderr files.
Return:

Returns the number of wide characters written or a negative number if it failed.

See Also:

"Wide Character and Byte Character Stream Orientation"

"vfprintf"


[ 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