Manpage of VIPRINTF

VIPRINTF

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

NAME

3.52 `viprintf', `vfiprintf', `vsiprintf'--format argument list

SYNOPSIS

     #include <stdio.h>
     #include <stdarg.h>
     int viprintf(const char *FMT, va_list LIST);
     int vfiprintf(FILE *FP, const char *FMT, va_list LIST);
     int vsiprintf(char *STR, const char *FMT, va_list LIST);
     int vasiprintf(char **STRP, const char *FMT, va_list LIST);
     int vsniprintf(char *STR, size_t SIZE, const char *FMT, va_list LIST);

     int _viprintf_r(struct _reent *REENT, const char *FMT,
         va_list LIST);
     int _vfiprintf_r(struct _reent *REENT, FILE *FP, const char *FMT,
         va_list LIST);
     int _vasiprintf_r(struct _reent *REENT, char **STR, const char *FMT,
         va_list LIST);
     int _vsiprintf_r(struct _reent *REENT, char *STR, const char *FMT,
         va_list LIST);
     int _vsniprintf_r(struct _reent *REENT, char *STR, size_t SIZE, const char *FMT,
         va_list LIST);

DESCRIPTION

`viprintf', `vfiprintf', `vasiprintf', `vsiprintf' and `vsniprintf' are (respectively) variants of `iprintf', `fiprintf', `asiprintf', `siprintf', and `sniprintf'. They differ only in restricting the caller to use non-floating-point format specifiers.

RETURNS

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

PORTABILITY

`viprintf', `vfiprintf', `vasiprintf', `vsiprintf' and `vsniprintf' are newlib extensions.

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