vprintf - Formatierte Ausgabe auf Standardausgabe

Definition	#include <stdio.h> int vprintf(const char *format, va_list arg); vprintf gleicht der Funktion printf. Im Unterschied zu printf erlaubt vprintf die Ausgabe von Argumenten, deren Anzahl und Datentyp zum Übersetzungszeitpunkt nicht bekannt sind. vprintf wird innerhalb von Funktionen benutzt, an die der Aufrufer jeweils eine andere Formatzeichenkette sowie andere auszugebende Argumente übergeben kann. Die Formalparameterliste der Funktionsdefinition sieht dafür eine Formatzeichenkette format und eine variable Argumentenliste ", ..." vor. format ist eine Formatzeichenkette wie bei printf mit ANSI-Funktionalität beschrieben (siehe dort). vprintf arbeitet eine Argumentenliste arg mit internen va_arg-Aufrufen sukzessive ab und schreibt die Argumente gemäß der Formatzeichenkette format auf die Standardausgabe stdout. Die variable Argumentenliste arg muss vor dem Aufruf von vprintf mit dem Makro va_start initialisiert worden sein.
Returnwert	Anzahl der ausgegebenen Zeichen bei Erfolg. Integer< 0       bei Fehler.
Hinweise	vprintf beginnt in der variablen Argumentenliste immer mit dem ersten Argument. Die Ausgabe ab einem beliebigen Argument lässt sich mit entsprechend vielen va_arg-Aufru-fen vor Aufruf der Funktion vprintf erreichen. Jeder va_arg-Aufruf positioniert die Argumentenliste um ein Argument weiter. vprintf ruft nicht das Makro va_end auf. Da vprintf das Makro va_arg benutzt, ist der Wert von arg nach der Rückkehr unbestimmt. Bei Textdateien mit der Zugriffsart SAM und variabler Satzlänge, für die zusätzlich eine maximale Satzlänge angegeben ist, gilt: Wenn bei fopen die Angabe split=no gemacht wurde, werden Sätze, die länger als die maximale Satzlänge sind, beim Schreiben auf die maximale Satzlänge gekürzt. Standardmäßig oder mit der Angabe split=yes werden diese Sätze in mehrere Sätze aufgeteilt. Hat ein Satz genau die maximale Satzlänge, wird nach diesem ein Satz der Länge Null geschrieben.
Beispiel	siehe bei vfprintf
Siehe auch	vfprintf, vsprintf, vsnprintf