Manpage of VPRINTF

VPRINTF

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents

NAME

3.50 `vprintf', `vfprintf', `vsprintf'--format argument list

SYNOPSIS

     #include <stdio.h>
     #include <stdarg.h>
     int vprintf(const char *FMT, va_list LIST);
     int vfprintf(FILE *FP, const char *FMT, va_list LIST);
     int vsprintf(char *STR, const char *FMT, va_list LIST);
     int vasprintf(char **STRP, const char *FMT, va_list LIST);
     int vsnprintf(char *STR, size_t SIZE, const char *FMT, va_list LIST);

     int _vprintf_r(struct _reent *REENT, const char *FMT,
         va_list LIST);
     int _vfprintf_r(struct _reent *REENT, FILE *FP, const char *FMT,
         va_list LIST);
     int _vasprintf_r(struct _reent *REENT, char **STR, const char *FMT,
         va_list LIST);
     int _vsprintf_r(struct _reent *REENT, char *STR, const char *FMT,
         va_list LIST);
     int _vsnprintf_r(struct _reent *REENT, char *STR, size_t SIZE, const char *FMT,
         va_list LIST);

DESCRIPTION

`vprintf', `vfprintf', `vasprintf', `vsprintf' and `vsnprintf' are (respectively) variants of `printf', `fprintf', `asprintf', `sprintf', and `snprintf'. They differ only in allowing their caller to pass the variable argument list as a `va_list' object (initialized by `va_start') rather than directly accepting a variable number of arguments.

RETURNS

The return values are consistent with the corresponding functions: `vasprintf'/`vsprintf' returns the number of bytes in the output string, save that the concluding `NULL' is not counted. `vprintf' and `vfprintf' return the number of characters transmitted. If an error occurs, `vprintf' and `vfprintf' return `EOF' and `vasprintf' returns -1. No error returns occur for `vsprintf'.

PORTABILITY

ANSI C requires all three functions.

Supporting OS subroutines required: `close', `fstat', `isatty', `lseek', `read', `sbrk', `write'.

This document was created by man2html, using the manual pages.
Time: 21:25:33 GMT, May 16, 2005