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
- Working Draft, Programming Languages — C++ (N4950; [temp.param] and [temp.arg.nontype])
- Declaring non-type template arguments with auto (P0127R2)
- Constant template arguments [temp.arg.nontype]
- Deducing template arguments from a type [temp.deduct.type]
- Alias templates [temp.alias]
- References [dcl.ref]
- Class template array — Overview [array.overview]