Funções com listas de argumento variável

Funções que requerem as listas de variáveis são declaradas usando-se as reticências (...) na lista do argumento, conforme descrito em Listas de argumentos de variável.Use os tipos e macros que são descritas o STDARG.H incluem o arquivo para acesso argumentos que são passados por uma lista variável.Para obter mais informações sobre essas macros, consulte va_arg, va_end, va_start na documentação da biblioteca de tempo de execução C.

Exemplo

A exemplo a seguir mostra como o va_start, va_arg, e va_end as macros trabalham em conjunto com o va_list tipo (declarado no 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 );
}

Comentários

O exemplo anterior ilustra esses conceitos importantes:

• Você deve estabelecer um marcador de lista como uma variável do tipo va_list antes de quaisquer argumentos de variáveis são acessados.No exemplo anterior, o marcador é chamado de vl.

• Os argumentos individuais são acessados usando o va_arg macro.Você deve informar o va_arg o tipo de argumento para recuperar para que ele possa transferir o número correto de bytes da pilha de macro.Se você especificar um tipo incorreto de um tamanho diferente daquela fornecida pelo programa de chamada para va_arg, os resultados serão imprevisíveis.

• Você deve converter explicitamente o resultado obtido por meio do va_arg macro para o tipo que você deseja.

• Você deve chamar o va_end macro para encerrar o processamento do argumento de variável.

Consulte também

Referência

Definições de função do C++