WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

Nicht-Typ-Templateparameter

Ein Nicht-Typ-Templateparameter erwartet einen Wert statt eines Typs. `std::size_t Size` legt die Arraylänge fest; der Compiler kann sie aus Funktionsargumenten ableiten.

Version: ISO C++23; implementation support may vary

Syntax

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;

In template<class T, std::size_t Size> erwartet T einen Typ, während Size als Nicht-Typ-Templateparameter (NTTP) einen Wert erwartet. Size ist der Parametername; 2 in AoS<2> ist das Templateargument. Die Länge gehört zum Arraytyp, daher sind AoS<2> und AoS<3> unterschiedliche Typen.

Ein Ausdruck für Size muss ein konvertierter konstanter Ausdruck vom Typ std::size_t aus <cstddef> sein. Möglich sind das Literal 2 oder constexpr std::size_t n = 2; zusammen mit AoS<n>. Eine zur Laufzeit eingelesene Länge erfüllt diese Anforderung nicht; AoS<n> mit einem solchen Argument führt zu einem Kompilierfehler.

Die Deklaration using AoS = std::array<Row, Size>; mit vorangestelltem Templatekopf definiert ein Alias-Template, keinen neuen Typ. In den Funktionsparametern deklariert & eine Lvalue-Referenz; es ermittelt keine Adresse. Über const AoS<Size>& source lässt sich das Quellarray nicht verändern, über AoS<Size>& destination dagegen das Zielarray des Aufrufers. Beide Referenzen binden an vorhandene Arrays; destination = source kopiert die Elemente und bindet keine Referenz neu.

Seit C++17 erlaubt template<auto Value>, den Parametertyp aus dem Argument abzuleiten. Das Argument muss weiterhin die NTTP-Regeln erfüllen. Seit C++20 sind unter anderem Gleitkommatypen und bestimmte literale Klassentypen zulässig, die die Anforderungen an Strukturtypen erfüllen. Für Zeiger- und Referenzargumente gelten eigene Einschränkungen: Sie dürfen etwa nicht auf temporäre Objekte oder Zeichenkettenliterale zeigen oder verweisen. Dieser Eintrag behandelt ISO C++23; die Unterstützung kann je nach Implementierung variieren.

Beispiele

#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';
}

Ergebnis

7 11

Bei `copy_rows(source, destination)` wird `Size = 2` aus den Typen beider Arrays abgeleitet. `copy_rows<2>(source, destination)` gibt denselben Wert explizit an. Bei unterschiedlichen Längen kompiliert der Aufruf ohne explizites Argument nicht, weil sich für `Size` widersprüchliche Werte ergeben. Erwartete Ausgabe: `7 11`.

Zugehörige Lektionen

  • C++ · Lektion 21 · Fortgeschritten · Version: 3

Quellen