Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

vprintf(3s) [hpux man page]

vprintf(3S)															       vprintf(3S)

NAME
vprintf(), vfprintf(), vsprintf(), vsnprintf() - print formatted output of a varargs argument list SYNOPSIS
DESCRIPTION
and are the same as and respectively, except that instead of being called with a variable number of arguments, they are called with an argument list as defined by RETURN VALUE
Each function returns the number of bytes transmitted (excluding the null byte character in the case of or a negative value if an output error was encountered. By default, returns a negative value if maxsize is smaller than the number of characters formatted. In the UNIX 2003 standards environment (see standards(5)) it returns the number of bytes that would have been written to buffer s, excluding the terminating null byte, if maxsize had been sufficiently large. EXAMPLES
The following demonstrates how could be used to write an error routine: #include <stdarg.h> #include <stdio.h> . . . /* * error should be called using the form: * error(function_name, format, arg1, arg2...); */ /*VARARGS0*/ void error(va_alist) va_dcl { va_list args; char *fmt; va_start(args); /* print out name of function causing error */ (void)fprintf(stderr, "ERROR in %s: ", va_arg(args, char *)); fmt = va_arg(args, char *); /* print out remainder of message */ (void)vfprintf(stderr, fmt, args); va_end(args); (void)abort( ); } SEE ALSO
setlocale(3C), printf(3S), standards(5), thread_safety(5), varargs(5), glossary(9). STANDARDS CONFORMANCE
vprintf(3S)

Check Out this Related Man Page

vprintf(3)						     Library Functions Manual							vprintf(3)

NAME
vprintf, vfprintf, vsnprintf, vsprintf - Format a variable number of parameters for output LIBRARY
Standard C Library (libc.so, libc.a) SYNOPSIS
#include <stdarg.h> #include <stdio.h> int vprintf( const char *format, va_list printarg); int vfprintf( FILE *stream, const char *format, va_list printarg); int vsnprintf( char *string, size_t n, const char *format, va_list printarg); int vsprintf( char *string, const char *format, va_list printarg); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: vfprintf(), vprintf(), vsnprintf(), vsprintf(): ISO C, XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about industry standards and associated tags. PARAMETERS
Specifies a character string that contains two types of objects: Plain characters, which are copied to the output stream. Conversion spec- ifications, each of which causes zero or more items to be fetched from the stdarg parameter lists. Specifies the arguments to be printed. Specifies the output stream. Specifies the buffer to which output is printed. Specifies the size of the buffer referred to by string. DESCRIPTION
The vprintf(), vfprintf(), vsnprintf(), and vsprintf() functions format and write stdarg parameter lists. These functions are the same as the printf(), fprintf(), snprintf(), and sprintf() functions, respectively, except that these functions are not called with a variable number of parameters. Instead, vprintf(), vfprintf(), vsnprintf(), and vsprintf() are called with a parameter list pointer as defined by stdarg. Because these functions invoke the va_arg() macro and not the va_end() macro, the value of printarg is indeterminate after a return. Therefore, applications should execute a call to the va_end() macro after a call to one of these functions. EXAMPLES
The following example demonstrates how the vfprintf() function can be used to write an error routine: #include <stdarg.h> #include <stdio.h> void error(char *funct, char *fmt, ...) { va_list args; /* ** Display the name of the function that called error */ fprintf(stderr, "ERROR in %s: ", funct); /* ** Display the remainder of the message */ va_start(args, fmt); vfprintf(stderr, fmt, args); va_end(args); abort(); } RELATED INFORMATION
Functions: fopen(3), printf(3), vwprintf(3), wprintf(3) delim off vprintf(3)
Man Page

Featured Tech Videos