Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

Pacote de parâmetros e expansão de pacotes

Um pacote de parâmetros aceita zero ou mais argumentos. Uma expansão de pacotes aplica um padrão a elementos sucessivos através de `...`. Distingue a declaração de um pacote, a sua expansão e a contagem dos seus elementos com `sizeof...`.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

template<class... Ts>
void relay(Ts... args) {
    target(args...);
}
// Pack size: sizeof...(Ts) or sizeof...(args)

parameter pack / pack expansion designa dois conceitos relacionados. Em template<class... Ts>, Ts designa um pacote de parâmetros de template de tipos. Em Ts... args, args designa um pacote de parâmetros de função; esta declaração também expande Ts.

Uma expansão de pacotes é um padrão com reticências: args... produz uma lista de elementos, não um único objeto. Os pacotes expandidos em conjunto têm de ter o mesmo comprimento. Escrever target(args) não expande o pacote; utiliza target(args...). sizeof...(args) indica o número de elementos, incluindo zero.

No exemplo, {0, args...} produz inicializadores do array. O 0 inicial garante que o array tem um elemento mesmo quando o pacote está vazio. As chamadas utilizam apenas valores int; a expansão não elimina os requisitos de inicialização dos elementos do array.

Não confundas Ts... args com as reticências em void f(int, ...): trata-se de outro mecanismo de argumentos. Esta entrada aborda C++23; o rascunho associado, que é atualizado ao longo do tempo, também inclui construções mais recentes. Não consideres que a página inteira descreve apenas C++23.

Exemplos

#include <iostream>

template<class... Ts>
void report(Ts... args) {
    std::cout << sizeof...(Ts) << ':';
    const int values[] = {0, args...};
    for (int value : values) {
        std::cout << ' ' << value;
    }
    std::cout << '\n';
}

int main() {
    report();
    report(4, 7, 9);
}

Resultado

0: 0
3: 0 4 7 9

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.

Fontes