CKTIS / C++
Função variádica ao estilo C: o parâmetro de reticências
Um ... no final de uma lista de parâmetros aceita argumentos adicionais sem tipos de parâmetros declarados. A função lê-os através de <cstdarg>, com base num número e em tipos acordados; erros nesse contrato podem causar comportamento indefinido.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
return_type function_name(fixed_parameters, ...);O parâmetro de reticências ao estilo C é o ... final numa declaração como int sum_ints(int count, ...);. A função aceita o argumento obrigatório count, seguido de zero ou mais argumentos adicionais. Os parâmetros normais mantêm a verificação de tipos, mas as reticências não especificam os tipos nem o número de argumentos adicionais. Não se trata de um pacote de parâmetros de modelo como Args....
O cabeçalho <cstdarg> disponibiliza std::va_list e macros para acesso sequencial. No exemplo, va_start(args, count) inicia a leitura, va_arg(args, int) obtém o argumento seguinte como int e va_end(args) termina a utilização da lista. count é um acordo com quem chama, não um número verificado automaticamente pela linguagem. Ler para além dos argumentos fornecidos ou usar um tipo incompatível causa comportamento indefinido, exceto nos casos definidos pela norma.
Os argumentos passados através de ... estão sujeitos às promoções predefinidas dos argumentos: float passa a double, enquanto bool, char e short são sujeitos a promoções integrais para int ou, quando as regras o exigem, para unsigned int. Obtém o tipo promovido, por exemplo double, e não float. O exemplo usa apenas argumentos int, cuja soma cabe num int. Usa a forma de dois argumentos de va_start adequada a C++23. As fontes fornecidas são um projeto de norma atualizado continuamente, não um texto C++23 fixo.
Exemplos
#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';
}
Resultado
60 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.