CKTIS / C++
std::integral — contraindre les types entiers
std::integral de <concepts> vérifie à la compilation si un type est entier. Il inclut aussi bool et les types caractères, conserve son résultat avec les qualificatifs const et volatile, mais rejette les références, les énumérations et les types à virgule flottante.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <concepts>
// Definition in namespace std:
template<class T>
concept integral = is_integral_v<T>;
// Usage:
// template<std::integral T> ...
// template<class T> requires std::integral<T> ...std::integral<T> est un concept de <concepts>, défini comme std::is_integral_v<T>. Il vérifie une catégorie de type à la compilation, et non la valeur d’un argument : double ne le satisfait pas, même s’il contient 4.0.
Le concept inclut les types entiers signés et non signés, ainsi que bool et les types caractères comme char et wchar_t. Les types énumérés et les classes ne le satisfont pas simplement parce qu’ils peuvent être convertis en int. Les qualificatifs const et volatile ne changent pas le résultat : std::integral<const int> est vrai. En revanche, les références ne sont pas des types entiers : std::integral<int&> est donc faux.
Utilisez template<std::integral T> pour contraindre l’argument de type T ; vous pouvez aussi écrire template<class T> requires std::integral<T>. Lorsque T est déduit d’un paramètre passé par valeur, comme dans l’exemple, un argument double ordinaire ne satisfait pas la contrainte. Il s’agit d’un test de type, et non d’un test général de convertibilité.
std::signed_integral et std::unsigned_integral distinguent en plus le signe. Attention : bool satisfait std::unsigned_integral, et la classification de char selon son signe dépend de l’implémentation. std::integral seul n’exclut donc ni les valeurs booléennes ni les caractères ; ajoutez des contraintes distinctes si votre algorithme ne les prend pas en charge.
Exemples
#include <concepts>
#include <iostream>
enum Number { one = 1 };
static_assert(std::integral<int>);
static_assert(std::integral<const volatile int>);
static_assert(std::integral<bool>);
static_assert(std::integral<char>);
static_assert(!std::integral<int&>);
static_assert(!std::integral<double>);
static_assert(!std::integral<Number>);
template<std::integral T>
constexpr bool is_even(T value) {
return value % 2 == 0;
}
int main() {
std::cout << std::boolalpha
<< is_even(42) << ' '
<< is_even(7u) << '\n';
}
Résultat
true false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.