WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

Variadische Funktion im C-Stil: der Ellipsenparameter

Ein abschließendes ... in einer Parameterliste akzeptiert zusätzliche Argumente ohne deklarierte Parametertypen. Die Funktion liest sie mit <cstdarg> aus und verlässt sich dabei auf eine vereinbarte Anzahl und Typen; Fehler bei dieser Vereinbarung können undefiniertes Verhalten verursachen.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

return_type function_name(fixed_parameters, ...);

Der Ellipsenparameter im C-Stil ist das abschließende ... in einer Deklaration wie int sum_ints(int count, ...);. Die Funktion akzeptiert das erforderliche Argument count, gefolgt von null oder mehr zusätzlichen Argumenten. Für gewöhnliche Parameter bleibt die Typprüfung erhalten, doch die Ellipse legt weder Typen noch Anzahl der zusätzlichen Argumente fest. Sie ist kein Template-Parameterpaket wie Args....

Der Header <cstdarg> stellt std::va_list und Makros für den sequenziellen Zugriff bereit. Im Beispiel beginnt va_start(args, count) das Durchlaufen, va_arg(args, int) ruft das nächste Argument als int ab und va_end(args) beendet die Verwendung der Liste. count ist eine Vereinbarung mit dem Aufrufer und keine Anzahl, die automatisch von der Sprache geprüft wird. Das Lesen über die übergebenen Argumente hinaus oder die Verwendung eines inkompatiblen Typs führt, abgesehen von standarddefinierten Ausnahmen, zu undefiniertem Verhalten.

Argumente, die über ... übergeben werden, unterliegen den Standardargument-Promotions: float wird zu double, während bool, char und short ganzzahligen Promotions zu int oder, wenn die Regeln es erfordern, zu unsigned int unterliegen. Lies den promovierten Typ aus, zum Beispiel double statt float. Das Beispiel verwendet ausschließlich int-Argumente, deren Summe in einen int passt. Es verwendet die für C++23 geeignete zweiparametrige Form von va_start. Die angegebenen Quellen sind ein fortlaufend aktualisierter Standardentwurf und kein eingefrorener C++23-Text.

Beispiele

#include <cstdarg>
#include <iostream>

int sum_ints(int count, ...) {
    std::va_list args;
    va_start(args, count);
    int total = 0;
    for (int i = 0; i < count; ++i) {
        total += va_arg(args, int);
    }
    va_end(args);
    return total;
}

int main() {
    std::cout << sum_ints(3, 10, 20, 30) << '\n';
    std::cout << sum_ints(0) << '\n';
}

Ergebnis

60
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen