具有變數引數清單的函式
需要變數清單的函式是使用引數清單中的省略符號 (...) 宣告，如變數引數清單中所述。 使用 STDARG.H Include 檔案中所述的類型和巨集，即可存取變數清單傳遞的引數。 如需這些巨集的詳細資訊，請參閱 C 執行階段程式庫文件中的 va_arg、va_end、va_start。
範例
下列範例將示範 va_start、va_arg 和 va_end 巨集如何搭配 va_list 類型運作 (在 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 );
}
註解
前述範例說明了下列重要概念：
您必須先建立清單標記做為 va_list 類型的變數，才能存取任何變數引數。 在上述範例中，標記稱為 vl。
個別引數是使用 va_arg 巨集存取。 您必須告知 va_arg 巨集要擷取的引數類型，以便從堆疊傳送正確的位元組數目。 如果您對 va_arg 指定的大小類型不正確，且與呼叫程式所提供的大小不同，則結果將無法預期。
您應該將使用 va_arg 巨集取得的結果明確轉型為您需要的類型。
您必須呼叫 va_end 巨集終止處理變數引數。