Funkcje z listy argumentów zmiennej
Funkcje, które wymagają listy zmiennych są deklarowane przy użyciu wielokropek (...) na liście argumentów, jak opisano w Zawiera listę argumentów zmiennej.Użyj typy i makra, które są opisane w STDARG.H dołączyć plik do argumentów dostępu, które są przekazywane przez lista zmiennych.Aby uzyskać więcej informacji na temat makr, zobacz va_arg, va_end, va_start w dokumentacji biblioteki uruchomieniowej C.
Przykład
W poniższym przykładzie jak va_start, va_arg, i va_end makra działać wraz z va_list typu (zadeklarowane w STDARG.H):
// variable_argument_lists.cpp
#include <stdio.h>
#include <stdarg.h>
// Declaration, but not definition, of ShowVar.
void ShowVar( char *szTypes, ... );
int main() {
ShowVar( "fcsi", 32.4f, 'a', "Test string", 4 );
}
// ShowVar takes a format string of the form
// "ifcs", where each character specifies the
// type of the argument in that position.
//
// i = int
// f = float
// c = char
// s = string (char *)
//
// Following the format specification is a variable
// list of arguments. Each argument corresponds to
// a format character in the format string to which
// the szTypes parameter points
void ShowVar( char *szTypes, ... ) {
va_list vl;
int i;
// szTypes is the last argument specified; you must access
// all others using the variable-argument macros.
va_start( vl, szTypes );
// Step through the list.
for( i = 0; szTypes[i] != '\0'; ++i ) {
union Printable_t {
int i;
float f;
char c;
char *s;
} Printable;
switch( szTypes[i] ) { // Type to expect.
case 'i':
Printable.i = va_arg( vl, int );
printf_s( "%i\n", Printable.i );
break;
case 'f':
Printable.f = va_arg( vl, double );
printf_s( "%f\n", Printable.f );
break;
case 'c':
Printable.c = va_arg( vl, char );
printf_s( "%c\n", Printable.c );
break;
case 's':
Printable.s = va_arg( vl, char * );
printf_s( "%s\n", Printable.s );
break;
default:
break;
}
}
va_end( vl );
}
Komentarze
Poprzedni przykład ilustruje te ważne pojęcia:
Należy ustanowić znacznik listy jako zmienna typu va_list przed uzyskaniem dostępu do żadnych argumentów zmiennej.W poprzednim przykładzie, znacznik jest nazywany vl.
Poszczególne argumenty są dostępne za pomocą va_arg makro.Trzeba poinformować va_arg makro typ argumentu, aby pobrać tak, aby ją przenieść poprawną liczbę bajtów ze stosu.Jeżeli określono nieprawidłowy typ inny niż dostarczone przez program wywołujący ma rozmiar va_arg, wyniki są nieprzewidywalne.
Należy jawnie oddanych wynik otrzymany za pomocą va_arg makro do typu, który ma.
Musisz wywołać va_end makro w celu zakończenia przetwarzania argument zmiennej.