CKTIS / C++
Variadická funkce ve stylu C: parametr s výpustkou
Závěrečné ... v seznamu parametrů přijímá další argumenty bez deklarovaných typů parametrů. Funkce je čte pomocí <cstdarg> a spoléhá na dohodnutý počet a typy; chyby v této dohodě mohou způsobit nedefinované chování.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
return_type function_name(fixed_parameters, ...);Parametr s výpustkou ve stylu C je závěrečné ... v deklaraci, jako je int sum_ints(int count, ...);. Funkce přijímá povinný argument count následovaný nulou nebo více dalšími argumenty. Běžné parametry si zachovávají kontrolu typů, ale výpustka neurčuje ani typy, ani počet dalších argumentů. Nejde o balíček parametrů šablony, jako je Args....
Hlavička <cstdarg> poskytuje std::va_list a makra pro sekvenční přístup. V příkladu zahájí va_start(args, count) procházení, va_arg(args, int) načte další argument jako int a va_end(args) ukončí práci se seznamem. count je dohoda s volajícím, nikoli počet automaticky kontrolovaný jazykem. Čtení za hranicí předaných argumentů nebo použití nekompatibilního typu způsobuje nedefinované chování, s výjimkou případů stanovených standardem.
Argumenty předávané přes ... podléhají výchozím povýšením argumentů: float se změní na double, zatímco bool, char a short podléhají celočíselným povýšením na int, případně, vyžadují-li to pravidla, na unsigned int. Načítejte povýšený typ, například double, nikoli float. Příklad používá pouze argumenty int, jejichž součet se vejde do int. Používá dvouargumentovou podobu va_start vhodnou pro C++23. Uvedené zdroje jsou průběžně aktualizovaný návrh standardu, nikoli neměnný text C++23.
Příklady
#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';
}
Výsledek
60 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.