va_start - variable Argumentliste initialisieren

Definition	#include <stdarg.h> Optional #include <varargs.h> (Ende) void va_start(va_list ap, parmN);
Beschreibung	Die Makros va_start, va_arg und va_end erlauben es, portable Prozeduren mit variablen Argumentlisten, wie sie in stdarg.h definiert sind, zu schreiben. Sie dienen zur Bearbeitung einer Argumentliste, deren Anzahl und Typ bei jedem Funktionsaufruf variieren kann. va_start initialisiert die variable Argumentliste ap für nachfolgende va_arg- und va_end-Aufrufe. ap ist ein Zeiger auf die Argumentliste. parmN ist der Name des letzten Arguments der variablen Argumentliste. Funktionen, die variable Argumentlisten verarbeiten, müssen mindestens ein Argument definieren.
Returnwert	Anzahl der ausgegebenen Zeichen
		bei Erfolg.
	0	bei Fehler.
Hinweise	Das Verhalten ist undefiniert, wenn parmN einen unzulässigen Datentyp hat oder wenn der Datentyp nicht zum aktuellen Argument passt. Die Kompatibilität von Argumenttypen wird vom C-Laufzeitsystem dahingehend unterstützt, dass ähnliche Typen in derselben Weise in der Parameterliste abgelegt werden, und zwar: Alle unsigned-Typen (inkl. char) werden wie unsigned int dargestellt (rechtsbündig in einem Wort). Alle anderen ganzzahligen Typen werden wie int dargestellt (rechtsbündig in einem Wort). float wird wie double dargestellt (rechtsbündig in einem Doppelwort).
Siehe auch	va_arg(), va_end(), stdarg.h, varargs.h.