CKTIS / C++
requires — ограничения и проверка на изисквания
Ключовата дума requires въвежда клауза, която ограничава декларация, или израз, който проверява изисквания към типове и операции. Разграничаването на тези употреби помага да се пишат шаблони, чиято наличност зависи от възможностите на зададения тип.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
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 има две основни употреби. Клаузата requires задава ограничението на декларация: може да следва списъка с параметри на шаблона или да се появи като заключителна клауза на функция. Неизпълнените ограничения изключват функция от множеството подходящи кандидати при разрешаване на претоварване; те не избират клон по време на изпълнение.
Изразът requires, requires (T x) { ... }, дава стойност от тип bool; списъкът му с параметри е незадължителен. Локалните параметри служат само за записване на изисквания — те не създават обекти. В requires requires (T x) { x + x; } първото requires започва клауза, а второто — израз.
Във фигурните скоби има четири вида изисквания: простото изискване x + x; проверява валидността на израз; изискването за тип typename T::value_type; проверява име на тип; съставното изискване { x + x } noexcept -> ResultConcept; проверява дали изразът е валиден, дали не е класифициран като потенциално хвърлящ изключение и дали decltype((x + x)) удовлетворява концепцията; вложеното изискване requires Constraint<T>; изисква да бъде изпълнено ограничение. И noexcept, и -> ResultConcept са незадължителни. Проверката с noexcept се основава на класификацията на израза според правилата на езика, а не на това дали при изпълнение действително може да бъде хвърлено изключение. Претоварен оператор, деклариран с noexcept, може да хвърли изключение в тялото си; ако изключение се разпространи извън оператора, се извиква std::terminate. Операндите на простите и съставните изисквания не се оценяват; само по себе си x == x; не изисква резултат true.
Неуспешно заместване в непосредствения контекст на изискванията на шаблон може да доведе до false вместо до грешка при компилация. Това не е универсален механизъм за потискане на грешки: невалидно изискване извън декларацията на шаблонна единица прави програмата невалидна. Ако заместването с аргументите на шаблона в дадено изискване неизменно би било неуспешно, програмата е невалидна и не се изисква диагностично съобщение. Неизпълненото изискване само по себе си не означава неуспешно заместване: вложеното изискване requires false; може да доведе до резултат false за израза requires при всяко заместване, без това да прави програмата невалидна.
В примера концепцията Addable съдържа израз requires, а add има клауза requires Addable<T>. Проверките static_assert обхващат поддържан тип, неподдържан тип и резултата от събирането. Този запис се отнася до C++23; предоставеният документ е развиващ се работен проект, а не окончателна публикация на C++23.
Примери
#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';
}
Резултат
5
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.