vprintf - Formatierte Ausgabe auf Standardausgabe

Definition	#include <stdio.h> int vprintf(const char *format, va_list arg);
Beschreibung	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-Aufrufen 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. BS2000 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. (Ende)
Siehe auch	vfprintf(), vsprintf().