CKTIS / C++
requires — obmedzenia a kontrola požiadaviek
Kľúčové slovo requires uvádza buď klauzulu obmedzujúcu deklaráciu, alebo výraz kontrolujúci požiadavky na typy a operácie. Rozlíšenie týchto použití pomáha písať šablóny, ktorých dostupnosť závisí od schopností zadaného typu.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
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á dve hlavné použitia. Klauzula requires určuje obmedzenie deklarácie: môže nasledovať po zozname parametrov šablóny alebo sa objaviť ako záverečná klauzula funkcie. Nesplnené obmedzenia vylučujú funkciu z množiny vhodných kandidátov pri rozlišovaní preťaženia; nevyberajú vetvu počas behu.
Výraz requires, requires (T x) { ... }, vytvára hodnotu typu bool; jeho zoznam parametrov je voliteľný. Lokálne parametre slúžia len ako zápis požiadaviek — nevytvárajú objekty. V requires requires (T x) { x + x; } prvé requires začína klauzulu a druhé výraz.
V zložených zátvorkách sú štyri druhy požiadaviek: jednoduchá požiadavka x + x; kontroluje platnosť výrazu; typová požiadavka typename T::value_type; kontroluje názov typu; zložená požiadavka { x + x } noexcept -> ResultConcept; kontroluje, či je výraz platný, či nie je klasifikovaný ako potenciálne vyvolávajúci výnimku a či decltype((x + x)) spĺňa koncept; vnorená požiadavka requires Constraint<T>; vyžaduje splnenie obmedzenia. noexcept aj -> ResultConcept sú voliteľné. Kontrola s noexcept vychádza z klasifikácie výrazu podľa pravidiel jazyka, nie z toho, či sa počas vykonávania môže skutočne vyvolať výnimka. Preťažený operátor deklarovaný ako noexcept môže vo svojom tele vyvolať výnimku; ak sa výnimka rozšíri mimo operátora, zavolá sa std::terminate. Operandy jednoduchých a zložených požiadaviek sa nevyhodnocujú; samotné x == x; nevyžaduje výsledok true.
Zlyhanie substitúcie v bezprostrednom kontexte požiadaviek šablóny môže viesť k výsledku false namiesto chyby kompilácie. Nie je to univerzálny mechanizmus na potláčanie chýb: neplatná požiadavka mimo deklarácie šablónovej entity spôsobí, že program je chybný. Ak by dosadenie argumentov šablóny do požiadavky vždy viedlo k zlyhaniu substitúcie, program je chybný a diagnostika sa nevyžaduje. Nesplnená požiadavka sama osebe neznamená zlyhanie substitúcie: vnorená požiadavka requires false; môže spôsobiť, že výraz requires bude mať pri každej substitúcii hodnotu false bez toho, aby bol program chybný.
V príklade koncept Addable obsahuje výraz requires, zatiaľ čo add má klauzulu requires Addable<T>. Kontroly static_assert zahŕňajú podporovaný typ, nepodporovaný typ a výsledok sčítania. Tento záznam sa týka C++23; dodaný dokument je priebežne sa vyvíjajúci pracovný návrh, nie nemenné vydanie C++23.
Prí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ýsledok
5
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.