具有變數引數清單的函式 (C++)

發行項
10/12/2023

最後一個成員是省略符號 (...) 的函式宣告可以接受可變數目的引數。在這些情況下，C++ 只會針對明確宣告的引數提供類型檢查。需要撰寫連引數數目和類型都可以不同的一般函式時，您可以使用變數引數清單。函式系列是使用變數引數清單的函式範例。 printfargument-declaration-list

具有變數引數的函式

若要在宣告引數之後存取引數，請使用標準 include 檔案 < stdarg.h > 中包含的宏，如下所述。

Microsoft 特定的

如果省略符號是最後一個引數，且省略符號在逗號之後，則 Microsoft C++ 允許將省略符號指定為引數。因此，int Func( int i, ... ); 宣告是合法的，int Func( int i ... ); 則不合法。

END Microsoft 特定的

宣告接受可變引數數目的函式至少需要一個預留位置引數 (即使不使用該引數)。如果未提供這個預留位置引數，就無法存取其餘引數。

當型 char 別的引數當做變數引數傳遞時，它們會轉換成類型 int 。同樣地，當型 float 別的引數當做變數引數傳遞時，它們會轉換成類型 double 。其他類型的引數受限於一般整數和浮點數提升。如需詳細資訊，請參閱標準轉換。

需要變數清單的函式是使用引數清單中的省略符號 (...) 宣告。使用 stdarg.h > 包含檔案中所述 < 的類型和宏來存取變數清單所傳遞的引數。如需這些宏的詳細資訊，請參閱 va_arg、va_copy、va_end va_start 。 (位於 C 執行階段程式庫文件中)。

下列範例顯示宏如何與類型一起運作（在 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 );
}
//Output:
// 32.400002
// a
// Test string

前述範例說明了下列重要概念：

您必須先建立清單標記做為 va_list 類型的變數，才能存取任何變數引數。在上述範例中，標記稱為 vl。
個別引數是使用 va_arg 巨集存取。您必須告知 va_arg 巨集要擷取的引數類型，以便從堆疊傳送正確的位元組數目。如果您對 va_arg 指定的大小類型不正確，且與呼叫程式所提供的大小不同，則結果將無法預期。
您應該將使用 va_arg 巨集取得的結果明確轉型為您需要的類型。

您必須呼叫 va_end 巨集終止處理變數引數。

具有變數引數清單的函式 (C++)

具有變數引數的函式

意見反應

意見反應

其他資源