CKTIS / C++
requires — omejitve in preverjanje zahtev
Ključna beseda requires uvede klavzulo, ki omejuje deklaracijo, ali izraz, ki preverja zahteve za tipe in operacije. Razlikovanje teh uporab pomaga pisati predloge, katerih razpoložljivost je odvisna od zmožnosti podanega tipa.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
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 ima dve glavni uporabi. Klavzula requires določa omejitev deklaracije: sledi lahko seznamu parametrov predloge ali pa se pojavi kot zaključna klavzula funkcije. Neizpolnjene omejitve funkcijo izločijo iz nabora ustreznih kandidatov pri razreševanju preobremenitev; ne izberejo veje med izvajanjem.
Izraz requires, requires (T x) { ... }, ustvari vrednost tipa bool; seznam parametrov ni obvezen. Lokalni parametri so namenjeni le zapisu zahtev — ne ustvarijo objektov. V requires requires (T x) { x + x; } prvi requires začne klavzulo, drugi pa izraz.
V zavitih oklepajih so štiri vrste zahtev: preprosta zahteva x + x; preveri veljavnost izraza; tipska zahteva typename T::value_type; preveri ime tipa; sestavljena zahteva { x + x } noexcept -> ResultConcept; preveri, ali je izraz veljaven, ali ni razvrščen med izraze, ki lahko sprožijo izjemo, in ali decltype((x + x)) izpolnjuje koncept; ugnezdena zahteva requires Constraint<T>; zahteva izpolnjevanje omejitve. Tako noexcept kot -> ResultConcept sta neobvezna. Pri preverjanju z noexcept je odločilna razvrstitev izraza po pravilih jezika, ne pa to, ali se med izvajanjem dejansko lahko sproži izjema. Preobremenjeni operator, deklariran kot noexcept, lahko v svojem telesu sproži izjemo; če se izjema razširi izven operatorja, se pokliče std::terminate. Operandi preprostih in sestavljenih zahtev se ne vrednotijo; x == x; samo po sebi ne zahteva rezultata true.
Napaka pri substituciji v neposrednem kontekstu zahtev predloge lahko povzroči false namesto napake pri prevajanju. To ni univerzalen mehanizem za zatiranje napak: neveljavna zahteva zunaj deklaracije entitete predloge pomeni, da je program napačno oblikovan. Če bi vstavljanje argumentov predloge v zahtevo vedno povzročilo napako pri substituciji, je program napačno oblikovan, diagnostika pa ni obvezna. Neizpolnjena zahteva sama po sebi ne pomeni napake pri substituciji: ugnezdena zahteva requires false; lahko povzroči, da ima izraz requires pri vsaki substituciji vrednost false, ne da bi bil program zato napačno oblikovan.
V primeru koncept Addable vsebuje izraz requires, medtem ko ima add klavzulo requires Addable<T>. Preverjanja static_assert zajemajo podprt tip, nepodprt tip in rezultat seštevanja. Ta vnos obravnava C++23; priloženi dokument je razvijajoči se delovni osnutek, ne nespremenjena objava standarda C++23.
Primeri
#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';
}
Rezultat
5
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.