Variadic arguments

Permet à une fonction d'accepter n'importe quel nombre d'arguments supplémentaires.

Une fonction est variadique si le dernier paramètre de sa liste de paramètres est une ellipse ( ... ).

// la fonction déclarée comme suit
int printx(const char* fmt, ...);
int printx(const char* fmt...); // identique à ci-dessus, mais obsolète depuis C++26
// peut être appelée avec un ou plusieurs arguments :
printx("hello world");
printx("a=%d b=%d", a, b);
int printy(..., const char* fmt); // erreur : ... ne peut être que le dernier paramètre
int printz(...); // valide, mais les arguments ne peuvent être accédés de manière portable

Promotions d'arguments par défaut

Lorsqu'une fonction variadique est appelée, après les conversions lvalue-en-rvalue, tableau-en-pointeur et fonction-en-pointeur conversions , chaque argument faisant partie de la liste d'arguments variables subit des conversions supplémentaires appelées promotions d'arguments par défaut :

• float arguments are converted to double as in floating-point promotion .
• bool , char , short , and unscoped enumerations are converted to int or wider integer types as in integral promotion .

Types de classes non-POD (jusqu'à C++11) Énumérations scopées et types de classes avec un constructeur de copie non trivial éligible, un constructeur de déplacement non trivial éligible, ou un destructeur non trivial (depuis C++11) sont conditionnellement pris en charge dans les appels potentiellement évalués avec une sémantique définie par l'implémentation (ces types sont toujours pris en charge dans les appels non évalués ).

Parce que les paramètres variadiques ont le rang le plus bas pour l'objectif de la résolution de surcharge , ils sont couramment utilisés comme solutions de repli universelles dans SFINAE .

Dans le corps d'une fonction utilisant des arguments variadiques, les valeurs de ces arguments peuvent être accédées en utilisant les <cstdarg> facilités de la bibliothèque :

Le comportement de la macro va_start est indéfini si le dernier paramètre avant les points de suspension est de type référence, ou s'il est d'un type qui n'est pas compatible avec le type résultant des promotions d'arguments par défaut.

Alternatives

Notes

Dans le langage de programmation C jusqu'à C23, au moins un paramètre nommé doit apparaître avant le paramètre ellipsis, donc R printz ( ... ) ; n'est pas valide jusqu'à C23. En C++, cette forme est autorisée même si les arguments passés à une telle fonction ne sont pas accessibles, et est couramment utilisée comme surcharge de secours dans SFINAE , exploitant la priorité la plus faible de la conversion ellipsis dans la résolution de surcharge .

Cette syntaxe pour les arguments variadiques a été introduite en 1983 dans C++ sans la virgule avant les points de suspension. Lorsque C89 a adopté les prototypes de fonctions de C++, il a remplacé la syntaxe par une version exigeant la virgule. Pour la compatibilité, C++98 accepte à la fois le style C++ f ( int n... ) et le style C f ( int n, ... ) . La grammaire originale de style C++ est dépréciée depuis C++26.

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi