Funkcje z listami zmiennych argumentów
Funkcje, które wymagają listy zmiennych są deklarowane przy użyciu wielokropka (...) na liście argumentów, zgodnie z opisem w Lista zmiennych.Użyj typów i makr, które zostały opisane w dołączonym pliku STDARG.H aby uzyskać dostęp do argumentów, które są przekazywane przez listy zmiennych.Aby uzyskać więcej informacji dotyczących makr, zobacz va_arg, va_end, va_start w dokumentacji biblioteki wykonawczej C.
Przykład
W poniższym przykładzie pokazano sposób, w jaki makra va_start, va_arg, i va_end działają razem z typem va_list (zadeklarowanym 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 następujące ważne pojęcia:
Należy ustanowić znacznik listy jako zmienną typu va_list przed uzyskaniem dostępu do jakiejkolwiek zmiennej argumentu.W poprzednim przykładzie, marker to vl.
Dostęp do poszczególnych argumentów odbywa się za pomocą makra va_arg.Użytkownik musi powiadomić makro va_arg jaki typ argumentu należy pobrać, aby przenieść poprawną liczbę bajtów ze stosu.Jeżeli określono nieprawidłowy typ, o rozmiarze innym niż dostarczony przez program wywołujący do va_arg, wyniki będą nieprzewidywalne.
Należy jawnie zrzutować uzyskany wynik za pomocą makra va_arg do żądanego typu.
Należy wywołać makro va_end, aby zakończyć przetwarzanie argumentów.