包含变量自变量列表的函数 (C++)

项目
04/03/2023

如果函数声明中最后一个成员是省略号 (...)，则函数声明可采用数量可变的自变量。在这些情况下，C++ 只为显式声明的自变量提供类型检查。即使参数的数量和类型是可变的，在需要使函数泛化时也可使用变量参数列表。函数系列是指使用变量自变量列表的函数的示例。printfargument-declaration-list

包含变量自变量的函数

若要访问声明后的自变量，请使用包含在标准包含文件 <stdarg.h> 中的宏（如下所述）。

Microsoft 专用

Microsoft C++ 允许将省略号指定为参数（如果省略号是最后一个参数且在逗号的后面）。因此，声明 int Func( int i, ... ); 是合法的，但 int Func( int i ... ); 不是合法的。

结束 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++)

包含变量自变量的函数

反馈

反馈

其他资源