std::invocable, std::regular_invocable

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

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

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンセプトライブラリ

中核言語のコンセプト same_as (C++20) derived_from (C++20) convertible_to (C++20) common_reference_with (C++20) common_with (C++20) integral (C++20) signed_integral (C++20) unsigned_integral (C++20) floating_point (C++20) swappableswappable_with (C++20)(C++20) destructible (C++20) constructible_from (C++20) default_initializable (C++20)   move_constructible (C++20) copy_constructible (C++20) assignable_from (C++20)

比較のコンセプト equality_comparableequality_comparable_with (C++20)(C++20) totally_orderedtotally_ordered_with (C++20)(C++20) オブジェクトのコンセプト movable (C++20) copyable (C++20) semiregular (C++20) regular (C++20) 呼び出し可能オブジェクトのコンセプト invocableregular_invocable (C++20)(C++20) predicate (C++20) relation (C++20) equivalence_relation (C++20) strict_weak_order (C++20)

説明専用のコンセプト boolean-testable  (C++20)

 

ヘッダ <concepts> で定義
template< class F, class... Args > concept invocable =     requires(F&& f, Args&&... args) {         std::invoke(std::forward<F>(f), std::forward<Args>(args)...);             /* equality-preserving である必要はない */     };		(C++20以降)
template< class F, class... Args > concept regular_invocable = std::invocable<F, Args...>;		(C++20以降)

invocable コンセプトは、呼び出し可能な型 F が、関数テンプレート std::invoke を使用して引数リスト Args... で呼び出せることを指定します。

regular_invocable コンセプトは、invocable コンセプトに加えて、invoke 式が 等価性保存 であり、関数オブジェクトまたは引数を変更しないことを要求します。

等価性保持

標準ライブラリのコンセプトのrequires式で宣言された式は、(特に明記されていない限り)等価性保持である必要があります。

注記

invocable と regular_invocable の区別は純粋に意味論的なものです。

乱数生成器は invocable を満たす可能性がありますが、regular_invocable を満たすことはできません（コミカルな例を除く）。

参考文献

• C++23標準 (ISO/IEC 14882:2024)

• 18.7.2 Concept invocable [concept.invocable]

• 18.7.3 Concept regular_invocable [concept.regularinvocable]

• C++20 standard (ISO/IEC 14882:2020)

• 18.7.2 Concept invocable [concept.invocable]

• 18.7.3 Concept regular_invocable [concept.regularinvocable]

関連項目

is_invocableis_invocable_ris_nothrow_invocableis_nothrow_invocable_r (C++17)

ある型が与えられた引数型で（std::invokeのように）呼び出し可能であるかをチェックする (クラステンプレート)

外部リンク

invocable と regular_invocable の両方を満たす乱数生成器の ジョーク例。