Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

requires — omezení a kontrola požadavků

Klíčové slovo requires uvádí buď klauzuli omezující deklaraci, nebo výraz kontrolující požadavky na typy a operace. Rozlišení těchto použití pomáhá psát šablony, jejichž dostupnost závisí na schopnostech předaného typu.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

template<class T> requires Constraint<T> void f(T);
template<class T> void f(T) requires Constraint<T>;
requires (T x) { x + x; typename T::value_type; { x + x } noexcept -> ResultConcept; requires Constraint<T>; }

requires má dvě hlavní použití. Klauzule requires určuje omezení deklarace: může následovat za seznamem parametrů šablony nebo se objevit jako závěrečná klauzule funkce. Nesplněná omezení vyřazují funkci z množiny vhodných kandidátů při rozlišení přetížení; nevybírají větev za běhu.

Výraz requires, requires (T x) { ... }, vytváří hodnotu typu bool; jeho seznam parametrů je nepovinný. Lokální parametry slouží pouze jako zápis požadavků — nevytvářejí objekty. V requires requires (T x) { x + x; } první requires zahajuje klauzuli a druhé výraz.

Uvnitř složených závorek jsou čtyři druhy požadavků: jednoduchý požadavek x + x; kontroluje platnost výrazu; typový požadavek typename T::value_type; kontroluje název typu; složený požadavek { x + x } noexcept -> ResultConcept; kontroluje, zda je výraz platný, zda není klasifikován jako potenciálně vyhazující výjimku a zda decltype((x + x)) splňuje koncept; vnořený požadavek requires Constraint<T>; vyžaduje splnění omezení. noexcept i -> ResultConcept jsou nepovinné. Kontrola s noexcept vychází z klasifikace výrazu podle pravidel jazyka, nikoli z toho, zda lze za běhu skutečně vyhodit výjimku. Přetížený operátor deklarovaný jako noexcept může ve svém těle vyhodit výjimku; pokud se výjimka rozšíří mimo operátor, zavolá se std::terminate. Operandy jednoduchých a složených požadavků se nevyhodnocují; samotné x == x; nevyžaduje výsledek true.

Selhání substituce v bezprostředním kontextu požadavků šablony může vést k výsledku false místo chyby kompilace. Nejde o univerzální mechanismus potlačování chyb: neplatný požadavek mimo deklaraci šablonové entity způsobí, že program není správně utvořen. Pokud by dosazení argumentů šablony do požadavku vždy vedlo k selhání substituce, program není správně utvořen a diagnostika se nevyžaduje. Nesplnění požadavku samo o sobě není selháním substituce: vnořený požadavek requires false; může vést k tomu, že výraz requires bude mít při každé substituci hodnotu false, aniž by tím byl program chybně utvořen.

V příkladu obsahuje koncept Addable výraz requires, zatímco add má klauzuli requires Addable<T>. Kontroly static_assert zahrnují podporovaný typ, nepodporovaný typ a výsledek sčítání. Tento záznam se týká C++23; dodaný dokument je průběžně vyvíjený pracovní návrh, nikoli neměnné vydání C++23.

Příklady

#include <iostream>

template<class T>
concept Addable = requires(T a, T b) {
    a + b;
};

template<class T>
requires Addable<T>
constexpr auto add(T a, T b) {
    return a + b;
}

struct NoAdd {};

static_assert(Addable<int>);
static_assert(!Addable<NoAdd>);
static_assert(add(2, 3) == 5);

int main() {
    std::cout << add(2, 3) << '\n';
}

Výsledek

5

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje