標準ライブラリヘッダ <concepts>

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

標準ライブラリヘッダ

言語サポート
<cstddef> <cstdlib> <version> <limits> <climits>	<cfloat> <cstdint> <new> <typeinfo>	<source_location> <exception> <initializer_list> <compare>	<coroutine> <csignal> <csetjmp> <cstdarg>
コンセプト
<concepts>
診断
<stdexcept>	<cassert>	<cerrno>	<system_error>
汎用ユーティリティ
<utility> <memory> <memory_resource> <scoped_allocator>	<bitset> <tuple> <optional> <any>	<variant> <type_traits> <ratio> <chrono>	<typeindex> <functional> <ctime>
文字列
<string> <string_view> <cstring>	<charconv> <format>	<cctype> <cwctype>	<cwchar> <cuchar>
ローカライゼーション
<locale>	<codecvt>	<clocale>
コンテナ
<span> <array> <vector>	<deque> <forward_list> <list>	<map> <set> <queue>	<unordered_map> <unordered_set> <stack>
イテレータ
<iterator>
範囲
<ranges>
アルゴリズム
<algorithm>	<execution>
数値演算
<complex> <random>	<valarray> <numeric>	<bit> <numbers>	<cfenv> <cmath>
入出力
<iosfwd> <ios> <iomanip> <streambuf>	<istream> <ostream> <iostream>	<sstream> <spanstream> <fstream> <syncstream>	<cstdio> <cinttypes> <strstream>
正規表現
<regex>
ファイルシステムサポート
<filesystem>
スレッドサポート
<thread> <atomic> <mutex>	<shared_mutex> <condition_variable> <future>	<stop_token> <semaphore>	<latch> <barrier>
C互換
<ciso646> <cstdalign>	<cstdbool> <ccomplex>	<ctgmath> <stdatomic.h>

 

このヘッダはコンセプトライブラリの一部です。

コンセプト
コア言語のコンセプト
same_as (C++20)	型が別の型と同じであることを指定します (コンセプト)
derived_from (C++20)	型が別の型から派生していることを指定します (コンセプト)
convertible_to (C++20)	型が別の型に暗黙に変換可能であることを指定します (コンセプト)
common_reference_with (C++20)	2つの型が共通の参照型を共有することを指定します (コンセプト)
common_with (C++20)	2つの型が共通の型を共有することを指定します (コンセプト)
integral (C++20)	型が整数型であることを指定します (コンセプト)
signed_integral (C++20)	型が符号付き整数型であることを指定します (コンセプト)
unsigned_integral (C++20)	型が符号なし整数型であることを指定します (コンセプト)
floating_point (C++20)	型が浮動小数点型であることを指定します (コンセプト)
assignable_from (C++20)	型が別の型から代入可能であることを指定します (コンセプト)
swappableswappable_with (C++20)	型がスワップ可能であること、または2つの型がお互いにスワップ可能であることを指定します (コンセプト)
destructible (C++20)	その型のオブジェクトが破棄可能であることを指定します (コンセプト)
constructible_from (C++20)	その型の変数が与えられた実引数の集合から構築可能または束縛可能であることを指定します (コンセプト)
default_initializable (C++20)	その型のオブジェクトがデフォルト構築可能であることを指定します (コンセプト)
move_constructible (C++20)	その型のオブジェクトがムーブ構築可能であることを指定します (コンセプト)
copy_constructible (C++20)	その型のオブジェクトがコピー構築可能かつムーブ構築可能であることを指定します (コンセプト)
比較のコンセプト
equality_comparableequality_comparable_with (C++20)	演算子 == が同値関係であることを指定します (コンセプト)
totally_orderedtotally_ordered_with (C++20)	型の比較演算子が全順序を与えることを指定します (コンセプト)
オブジェクトのコンセプト
movable (C++20)	その型のオブジェクトがムーブ可能でありスワップ可能であることを指定します (コンセプト)
copyable (C++20)	その型のオブジェクトがコピー、ムーブ、およびスワップ可能であることを指定します (コンセプト)
semiregular (C++20)	その型のオブジェクトがコピー、ムーブ、スワップ、およびデフォルト構築可能であることを指定します (コンセプト)
regular (C++20)	型が普通である、つまり semiregular かつ equality_comparable であることを指定します (コンセプト)
呼び出し可能のコンセプト
invocableregular_invocable (C++20)	callable 型が与えられた実引数の型の集合で呼び出せることを指定します (コンセプト)
predicate (C++20)	callable 型がブーリアン述語であることを指定します (コンセプト)
relation (C++20)	callable 型が二項関係であることを指定します (コンセプト)
equivalence_relation (C++20)	relation が同値関係を課すことを指定します (コンセプト)
strict_weak_order (C++20)	relation が狭義弱順序を課すことを指定します (コンセプト)
カスタマイゼーションポイントオブジェクト
ranges::swap (C++20)	2つのオブジェクトの値を入れ替えます (カスタマイゼーションポイントオブジェクト)

概要

namespace std {
  // language-related concepts
  // concept same_as
  template<class T, class U>
    concept same_as = /* see description */;

  // concept derived_from
  template<class Derived, class Base>
    concept derived_from = /* see description */;

  // concept convertible_to
  template<class From, class To>
    concept convertible_to = /* see description */;

  // concept common_reference_with
  template<class T, class U>
    concept common_reference_with = /* see description */;

  // concept common_with
  template<class T, class U>
    concept common_with = /* see description */;

  // arithmetic concepts
  template<class T>
    concept integral = /* see description */;
  template<class T>
    concept signed_integral = /* see description */;
  template<class T>
    concept unsigned_integral = /* see description */;
  template<class T>
    concept floating_point = /* see description */;

  // concept assignable_from
  template<class LHS, class RHS>
    concept assignable_from = /* see description */;

  // concept swappable
  namespace ranges {
    inline namespace /* unspecified */ {
      inline constexpr /* unspecified */ swap = /* unspecified */;
    }
  }
  template<class T>
    concept swappable = /* see description */;
  template<class T, class U>
    concept swappable_with = /* see description */;

  // concept destructible
  template<class T>
    concept destructible = /* see description */;

  // concept constructible_from
  template<class T, class... Args>
    concept constructible_from = /* see description */;

  // concept default_initializable
  template<class T>
    concept default_initializable = /* see description */;

  // concept move_constructible
  template<class T>
    concept move_constructible = /* see description */;

  // concept copy_constructible
  template<class T>
    concept copy_constructible = /* see description */;

  // comparison concepts
  // concept equality_comparable
  template<class T>
    concept equality_comparable = /* see description */;
  template<class T, class U>
    concept equality_comparable_with = /* see description */;

  // concept totally_ordered
  template<class T>
    concept totally_ordered = /* see description */;
  template<class T, class U>
    concept totally_ordered_with = /* see description */;

  // object concepts
  template<class T>
    concept movable = /* see description */;
  template<class T>
    concept copyable = /* see description */;
  template<class T>
    concept semiregular = /* see description */;
  template<class T>
    concept regular = /* see description */;

  // callable concepts
  // concept invocable
  template<class F, class... Args>
    concept invocable = /* see description */;

  // concept regular_invocable
  template<class F, class... Args>
    concept regular_invocable = /* see description */;

  // concept predicate
  template<class F, class... Args>
    concept predicate = /* see description */;

  // concept relation
  template<class R, class T, class U>
    concept relation = /* see description */;

  // concept equivalence_relation
  template<class R, class T, class U>
    concept equivalence_relation = /* see description */;

  // concept strict_weak_order
  template<class R, class T, class U>
    concept strict_weak_order = /* see description */;
}

コンセプト same_as

template<class T, class U>
  concept __SameImpl = is_same_v<T, U>;  // exposition only

template<class T, class U>
  concept same_as = __SameImpl<T, U> && __SameImpl<U, T>;

コンセプト derived_from

template<class Derived, class Base>
  concept derived_from =
    is_base_of_v<Base, Derived> &&
    is_convertible_v<const volatile Derived*, const volatile Base*>;

コンセプト convertible_to

template<class From, class To>
  concept convertible_to =
    is_convertible_v<From, To> &&
    requires(From (&f)()) {
      static_cast<To>(f());
    };

コンセプト common_reference_with

template<class T, class U>
  concept common_reference_with =
    same_as<common_reference_t<T, U>, common_reference_t<U, T>> &&
    convertible_to<T, common_reference_t<T, U>> &&
    convertible_to<U, common_reference_t<T, U>>;

コンセプト common_with

template<class T, class U>
  concept common_with =
    same_as<common_type_t<T, U>, common_type_t<U, T>> &&
    requires {
      static_cast<common_type_t<T, U>>(declval<T>());
      static_cast<common_type_t<T, U>>(declval<U>());
    } &&
    common_reference_with<
      add_lvalue_reference_t<const T>,
      add_lvalue_reference_t<const U>> &&
    common_reference_with<
      add_lvalue_reference_t<common_type_t<T, U>>,
      common_reference_t<
        add_lvalue_reference_t<const T>,
        add_lvalue_reference_t<const U>>>;

コンセプト integral

template<class T>
  concept integral = is_integral_v<T>;

コンセプト signed_integral

template<class T>
  concept signed_integral = integral<T> && is_signed_v<T>;

コンセプト unsigned_integral

template<class T>
  concept unsigned_integral = integral<T> && !signed_integral<T>;

コンセプト floating_point

template<class T>
  concept floating_point = is_floating_point_v<T>;

コンセプト assignable_from

template<class LHS, class RHS>
  concept assignable_from =
    is_lvalue_reference_v<LHS> &&
    common_reference_with<
      const remove_reference_t<LHS>&,
      const remove_reference_t<RHS>&> &&
    requires(LHS lhs, RHS&& rhs) {
      { lhs = std::forward<RHS>(rhs) } -> same_as<LHS>;

コンセプト swappable

template<class T>
  concept swappable = requires(T& a, T& b) { ranges::swap(a, b); };

コンセプト swappable_with

template<class T, class U>
  concept swappable_with =
    common_reference_with<const remove_reference_t<T>&, const remove_reference_t<U>&> &&
    requires(T&& t, U&& u) {
      ranges::swap(std::forward<T>(t), std::forward<T>(t));
      ranges::swap(std::forward<U>(u), std::forward<U>(u));
      ranges::swap(std::forward<T>(t), std::forward<U>(u));
      ranges::swap(std::forward<U>(u), std::forward<T>(t));
    };

コンセプト destructible

template<class T>
  concept destructible = is_nothrow_destructible_v<T>;

コンセプト constructible_from

template<class T, class... Args>
  concept constructible_from = destructible<T> && is_constructible_v<T, Args...>;

コンセプト default_initializable

template<class T>
  inline constexpr bool __is_default_initializable =
    /* see desription */;  // exposition only

template<class T>
  concept default_initializable = constructible_from<T> &&
                                  requires{ T{}; } &&
                                  __is_default_initializable<T>;

コンセプト move_constructible

template<class T>
  concept move_constructible = constructible_from<T, T> && convertible_to<T, T>;

コンセプト copy_constructible

template<class T>
  concept copy_constructible =
    move_constructible<T> &&
    constructible_from<T, T&> && convertible_to<T&, T> &&
    constructible_from<T, const T&> && convertible_to<const T&, T> &&
    constructible_from<T, const T> && convertible_to<const T, T>;

コンセプト equality_comparable

template<class T, class U>
  concept __WeaklyEqualityComparableWith = // exposition only
    requires(const remove_reference_t<T>& t,
             const remove_reference_t<U>& u) {
      { t == u } -> boolean-testable;
      { t != u } -> boolean-testable;
      { u == t } -> boolean-testable;
      { u != t } -> boolean-testable;
    };

template<class T>
  concept equality_comparable = __WeaklyEqualityComparableWith<T, T>;

コンセプト equality_comparable_with

template<class T, class U>
  concept equality_comparable_with =
    equality_comparable<T> && equality_comparable<U> &&
    common_reference_with<const remove_reference_t<T>&, const remove_reference_t<U>&> &&
    equality_comparable<
      common_reference_t<
        const remove_reference_t<T>&,
        const remove_reference_t<U>&>> &&
    __WeaklyEqualityComparableWith<T, U>;

コンセプト totally_ordered

template<class T>
  concept totally_ordered =
    equality_comparable<T> &&
    requires(const remove_reference_t<T>& a,
             const remove_reference_t<T>& b) {
      { a <  b } -> boolean-testable;
      { a >  b } -> boolean-testable;
      { a <= b } -> boolean-testable;
      { a >= b } -> boolean-testable;
    };

コンセプト totally_ordered_with

template<class T, class U>
  concept totally_ordered_with =
    totally_ordered<T> && totally_ordered<U> &&
    common_reference_with<const remove_reference_t<T>&, const remove_reference_t<U>&> &&
    totally_ordered<
      common_reference_t<
        const remove_reference_t<T>&,
        const remove_reference_t<U>&>> &&
    equality_comparable_with<T, U> &&
    requires(const remove_reference_t<T>& t,
             const remove_reference_t<U>& u) {
      { t <  u } -> boolean-testable;
      { t >  u } -> boolean-testable;
      { t <= u } -> boolean-testable;
      { t >= u } -> boolean-testable;
      { u <  t } -> boolean-testable;
      { u >  t } -> boolean-testable;
      { u <= t } -> boolean-testable;
      { u >= t } -> boolean-testable;
    };

コンセプト movable

template<class T>
  concept movable = is_object_v<T> && move_constructible<T> &&
                    assignable_from<T&, T> && swappable<T>;

コンセプト copyable

template<class T>
  concept copyable = copy_constructible<T> && movable<T> && assignable_from<T&, T&> &&
                     assignable_from<T&, const T&> && assignable_from<T&, const T>;

コンセプト semiregular

template<class T>
  concept semiregular = copyable<T> && default_initializable<T>;

コンセプト regular

template<class T>
  concept regular = semiregular<T> && equality_comparable<T>;

コンセプト invocable

template<class F, class... Args>
  concept invocable = requires(F&& f, Args&&... args) {
    invoke(std::forward<F>(f), std::forward<Args>(args)...);
      // not required to be equality-preserving
  };

コンセプト regular_invocable

template<class F, class... Args>
  concept regular_invocable = invocable<F, Args...>;

コンセプト predicate

template<class F, class... Args>
  concept predicate =
    regular_invocable<F, Args...> && boolean-testable<invoke_result_t<F, Args...>>;

コンセプト relation

template<class R, class T, class U>
  concept relation =
    predicate<R, T, T> && predicate<R, U, U> &&
    predicate<R, T, U> && predicate<R, U, T>;

コンセプト equivalence_relation

template<class R, class T, class U>
  concept equivalence_relation = relation<R, T, U>;

コンセプト strict_weak_order

template<class R, class T, class U>
  concept strict_weak_order = relation<R, T, U>;