std::ranges::size

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

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

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

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

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

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

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

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

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

Rangesライブラリ

Rangeアクセス begin cbegin   end cend rbegin crbegin   rend crend size ssize   data cdata reserve_hint (C++26)   empty

Range変換 std::from_range_t std::from_range (C++23)(C++23)     to (C++23)

ダングリングイテレータの扱い dangling borrowed_iterator_t borrowed_subrange_t

Rangeプリミティブ
range_size_trange_difference_trange_value_t elements_of (C++23)	iterator_tconst_iterator_tsentinel_tconst_sentinel_t (C++23)(C++23)	range_reference_trange_const_reference_trange_rvalue_reference_trange_common_reference_t (C++23)

Rangeコンセプト
range borrowed_range    common_range	sized_range viewable_range    view	input_range output_range forward_range	bidirectional_range    random_access_range contiguous_range	approximately_sized_range (C++26) constant_range (C++23)

表示
view_interface	subrange

Rangeファクトリ
empty_viewviews::empty	single_viewviews::single	basic_istream_viewviews::istream	iota_viewviews::iota	repeat_viewviews::repeat (C++23)(C++23)

Rangeアダプタ
views::all_tviews::all as_rvalue_viewviews::as_rvalue (C++23)(C++23)   filter_viewviews::filter transform_viewviews::transform take_viewviews::take take_while_viewviews::take_while common_viewviews::common views::counted to_input_viewviews::to_input (C++26)(C++26)	ref_view drop_viewviews::drop drop_while_viewviews::drop_while lazy_split_viewviews::lazy_split split_viewviews::split join_viewviews::join join_with_viewviews::join_with (C++23)(C++23)   concat_viewviews::concat (C++26)(C++26) cache_latest_viewviews::cache_latest (C++26)(C++26)	owning_view reverse_viewviews::reverse as_const_viewviews::as_const (C++23)(C++23) elements_viewviews::elements keys_viewviews::keys values_viewviews::values enumerate_viewviews::enumerate (C++23)(C++23) zip_viewviews::zip (C++23)(C++23) zip_transform_viewviews::zip_transform (C++23)(C++23)	adjacent_viewviews::adjacent (C++23)(C++23) views::pairwise (C++23) adjacent_transform_viewviews::adjacent_transform (C++23)(C++23) views::pairwise_transform (C++23) chunk_viewviews::chunk (C++23)(C++23) slide_viewviews::slide (C++23)(C++23) chunk_by_viewviews::chunk_by (C++23)(C++23) stride_viewviews::stride (C++23)(C++23) cartesian_product_viewviews::cartesian_product (C++23)(C++23)

Rangeジェネレータ std::generator (C++23)

Rangeアダプタクロージャオブジェクト range_adaptor_closure (C++23)

Rangeアダプタオブジェクト

ヘルパーアイテム
copyable-box movable-box (C++23まで)  (C++23)	simple-view non-propagating-cache

 

ヘッダ <ranges> で定義
ヘッダ <iterator> で定義
inline namespace /* 未指定 */ {     inline constexpr auto size = /* 未指定 */; }		(C++20以降) (カスタマイズポイントオブジェクト)
呼び出しシグネチャ
template< class T >     requires /* 以下を参照 */ constexpr auto size( T&& t );		(C++20以降)

定数時間で t の要素数を計算します。

t が (必要に応じて 具体化された) 結果オブジェクトを示す 完全式を E とし、E の型を T とします。

• T が未知の境界を持つ配列の場合、ranges::size(E) は不定形です。
• それ以外の場合で、T が配列型の場合、ranges::size(E) は decay-copy (std::extent_v<T>)(until C++23)auto(std::extent_v<T>)(since C++23) に式同値です。
• それ以外の場合で、以下のすべての条件が満たされる場合、ranges::size(E) は decay-copy (t.size())(until C++23)auto(t.size())(since C++23) に式同値です。
  • ranges::disable_sized_range<std::remove_cv_t<T>> は false です。
  • decay-copy (t.size())(until C++23)auto(t.size())(since C++23) は有効な整数型のような式です。
• それ以外の場合で、以下のすべての条件が満たされる場合、ranges::size(E) は decay-copy (size(t))(until C++23)auto(size(t))(since C++23) に式同値です。
  • T はクラス型または列挙型です。
  • ranges::disable_sized_range<std::remove_cv_t<T>> は false です。
  • decay-copy (size(t))(until C++23)auto(size(t))(since C++23) は有効な整数型のような式です。ここで size の意味は、引数依存探索のみを実行した場合と同様に確立されます。
• それ以外の場合で、以下のすべての条件が満たされる場合、ranges::size(E) は to-unsigned-like (ranges::end(t) - ranges::begin(t)) に式同値です。
  • T は forward_range をモデル化します。
  • ranges::begin(t) の型を I とし、ranges::end(t) の型を S とすると、sized_sentinel_for<S, I> および forward_iterator<I> の両方がモデル化されます。
  • to-unsigned-like (ranges::end(t) - ranges::begin(t)) は有効な式です。
• それ以外の場合、ranges::size(E) は不定形です。

上記のような診断可能な不定形ケースは、ranges::size(E) がテンプレートインスタント化の直接のコンテキストに現れる場合、置換失敗につながります。

カスタマイゼーションポイントオブジェクト

ranges::size という名前は カスタム化ポイントオブジェクト を表します。これは、リテラルな semiregular クラス型の const 関数オブジェクトです。説明のために、その型の cv 修飾されていないバージョンを __size_fn と表記します。

__size_fn のすべてのインスタンスは等価です。同じ引数に対して呼び出された異なる __size_fn 型のインスタンスの呼び出し効果は、インスタンスを表す式が左辺値か右辺値か、また const 修飾されているか否かに関わらず同等です (ただし、volatile 修飾されたインスタンスは呼び出し可能である必要はありません)。したがって、ranges::size は自由にコピーでき、そのコピーは相互に交換可能に使用できます。

型 Args... のセットが与えられた場合、std::declval<Args>()... が上記の ranges::size への引数の要件を満たす場合、__size_fn は以下をモデル化します。

• std::invocable<__size_fn, Args...>,
• std::invocable<const __size_fn, Args...>,
• std::invocable<__size_fn&, Args...>、および
• std::invocable<const __size_fn&, Args...>.
  

それ以外の場合、__size_fn の関数呼び出し演算子のいずれもオーバーロード解決に参加しません。

注釈

ranges::size(e) が式 e に対して有効な場合、戻り値の型は 整数型のような型になります。

C++20 標準では、基となる size 関数呼び出しが prvalue を返す場合、戻り値は一時オブジェクトからムーブ構築されることを要求しています。すべての実装では、代わりに prvalue を直接返しています。この要件は、C++20 後に提案された P0849R8 によって、実装に合わせるように修正されています。

式 ranges::distance(e) は、範囲 e のサイズを決定するためにも使用できます。ranges::size(e) とは異なり、ranges::distance(e) は e がサイズ指定のない範囲であっても機能しますが、その場合線形時間計算量がかかります。

例

このコードを実行

#include <iostream>
#include <ranges>
#include <type_traits>
#include <vector>
 
int main()
{
    auto v = std::vector<int>{};
    std::cout << "ranges::size(v) == " << std::ranges::size(v) << '\n';
 
    auto il = {7};     // std::initializer_list
    std::cout << "ranges::size(il) == " << std::ranges::size(il) << '\n';
 
    int array[]{4, 5}; // array has a known bound
    std::cout << "ranges::size(array) == " << std::ranges::size(array) << '\n';
 
    static_assert(std::is_signed_v<decltype(std::ranges::size(v))> == false);
}

出力

ranges::size(v) == 0
ranges::size(il) == 1
ranges::size(array) == 2

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
P2602R2	C++20	ADL によって見つかる一部の非メンバ size を禁止する仕組みがあります。	その仕組みは削除されました。

関連項目

ranges::ssize (C++20)	rangeのサイズと等しい符号付き整数を返す (カスタマイゼーションポイントオブジェクト)
ranges::sized_range (C++20)	rangeが定数時間でそのサイズを知っていることを規定する (コンセプト)
ranges::distance (C++20)	イテレータと番兵 (sentinel) の間の距離、またはRangeの始点と終点の間の距離を返す (アルゴリズム関数オブジェクト)
sizessize (C++17)(C++20)	コンテナまたは配列のサイズを返す (関数テンプレート)