vprintf Function

Prints formatted text to stdout using a variable length argument list.

Include

<stdio.h>

<stdarg.h>

Prototype

int vprintf(const char *format, va_list ap);

Arguments

Return Value

Returns number of characters generated or a negative number if an error occurs.

Remarks

The format argument has the same syntax and use that it has in printf.

To access the variable length argument list, the ap variable must be initialized by the macro va_start and may be reinitialized by additional calls to va_arg. This must be done before the vprintf function is called. Invoke va_end after the function returns. For more details, see stdarg.h

Example

#include <stdio.h>   /* for vprintf, printf */
#include <stdarg.h>  /* for va_start,       */
                     /* va_list, va_end     */
void errmsg(const char *fmt, ...)
{
  va_list ap;

  va_start(ap, fmt);
  printf("Error: ");
  vprintf(fmt, ap);
  va_end(ap);
}
int main(void)
{
  int num = 3;

  errmsg("The letter '%c' is not %s\n", 'a', 
         "an integer value.");
  errmsg("Requires %d%s\n", num, 
         " or more characters.\n");
}

Example Output

Error: The letter 'a' is not an integer value.
Error: Requires 3 or more characters.