Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::integral — ograniczenie do typów całkowitych

std::integral z nagłówka <concepts> sprawdza podczas kompilacji, czy typ jest całkowity. Obejmuje także bool i typy znakowe, zachowuje wynik dla kwalifikatorów const i volatile, ale odrzuca referencje, wyliczenia i typy zmiennoprzecinkowe.

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

Składnia

#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> jest konceptem z nagłówka <concepts>, zdefiniowanym jako std::is_integral_v<T>. Sprawdza kategorię typu podczas kompilacji, a nie wartość argumentu: double nie spełnia go nawet wtedy, gdy przechowuje 4.0.

Koncept obejmuje typy całkowite ze znakiem i bez znaku, a także bool oraz typy znakowe, takie jak char i wchar_t. Typy wyliczeniowe i klasy nie spełniają go tylko dlatego, że można je konwertować do int. Kwalifikatory const i volatile nie zmieniają wyniku: std::integral<const int> jest prawdą. Referencje nie są jednak typami całkowitymi, więc std::integral<int&> jest fałszem.

Zapis template<std::integral T> ogranicza argument typu T; można też użyć template<class T> requires std::integral<T>. Gdy T jest dedukowany z parametru przekazywanego przez wartość, jak w przykładzie, zwykły argument typu double nie spełni ograniczenia. To test typu, nie ogólny test możliwości konwersji.

std::signed_integral i std::unsigned_integral dodatkowo rozróżniają właściwość znaku. Uwaga: bool spełnia std::unsigned_integral, a klasyfikacja char według znaku zależy od implementacji. Samo std::integral nie wyklucza więc wartości logicznych ani znaków; jeśli algorytm ich nie obsługuje, dodaj osobne ograniczenia.

Przykłady

#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';
}

Wynik

true false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła