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

CKTIS / C++

Parâmetros de template que não são tipos

Um parâmetro de template que não é um tipo recebe um valor. `std::size_t Size` fixa o tamanho do array, que o compilador pode deduzir a partir dos argumentos da função.

Versão: ISO C++23; implementation support may vary

Sintaxe

template<class T, std::size_t Size> struct Buffer;

template<std::size_t Size>
using AoS = std::array<Row, Size>;

template<std::size_t Size>
void copy_rows(const AoS<Size>& source, AoS<Size>& destination);

template<auto Value> struct Tag;

Em template<class T, std::size_t Size>, T recebe um tipo, enquanto Size é um parâmetro de template que não é um tipo (NTTP) e recebe um valor. Size é o nome do parâmetro; 2 em AoS<2> é o argumento de template. O tamanho faz parte do tipo do array: AoS<2> e AoS<3> são tipos diferentes.

Uma expressão passada para Size tem de ser uma expressão constante convertida para o tipo std::size_t, disponível em <cstddef>. Pode usar-se o literal 2 ou declarar constexpr std::size_t n = 2; e escrever AoS<n>. Um tamanho lido da entrada durante a execução não cumpre este requisito; usá-lo em AoS<n> provoca um erro de compilação.

A declaração using AoS = std::array<Row, Size>;, precedida pelo cabeçalho do template, define um template de alias, não um novo tipo. Nos parâmetros da função, & declara uma referência lvalue; não obtém um endereço. const AoS<Size>& source impede alterações à origem através dessa referência, enquanto AoS<Size>& destination permite modificar o array de destino de quem chama a função. As duas referências ligam-se a arrays existentes; destination = source copia os elementos, sem mudar o objeto ao qual uma referência está ligada.

Desde C++17, template<auto Value> permite deduzir o tipo do parâmetro a partir do argumento, que continua a ter de cumprir as regras dos NTTP. Desde C++20, são admitidos, entre outros, tipos de vírgula flutuante e certos tipos de classe literais que cumprem os requisitos de um tipo estrutural. Os argumentos de tipo ponteiro ou referência têm restrições próprias: por exemplo, não podem apontar ou referir-se a objetos temporários ou a literais de cadeia. Esta entrada abrange ISO C++23; o suporte pode variar consoante a implementação.

Exemplos

#include <array>
#include <cstddef>
#include <iostream>

struct Row {
    int value;
};

template<std::size_t Size>
using AoS = std::array<Row, Size>;

template<std::size_t Size>
void copy_rows(const AoS<Size>& source, AoS<Size>& destination)
{
    destination = source;
}

int main()
{
    const AoS<2> source{Row{7}, Row{11}};
    AoS<2> destination{};
    copy_rows(source, destination);
    std::cout << destination[0].value << ' ' << destination[1].value << '\n';
}

Resultado

7 11

`copy_rows(source, destination)` deduz `Size = 2` a partir dos tipos dos dois arrays. `copy_rows<2>(source, destination)` indica explicitamente o mesmo valor. Se os arrays tiverem tamanhos diferentes, a chamada sem argumento explícito não compila, pois a dedução produz valores incompatíveis para `Size`. Saída esperada: `7 11`.

Lições relacionadas

  • C++ · Lição 21 · Avançado · Versão: 3

Fontes