ssize.md

ssize

• ranges[meta header]
• std::ranges[meta namespace]
• cpo[meta id-type]
• cpp20[meta cpp]

namespace std::ranges {
  inline namespace /*unspecified*/ {
    inline constexpr /*unspecified*/ ssize = /*unspecified*/;
  }
}

概要

Rangeの要素数を符号付き整数型で取得する関数オブジェクト。

効果

式ranges::ssize(E)は、ranges::size(E)が有効な式であるときに有効であり、static_cast<D>(ranges::size(E))と等しい。ここでDは、decltype(ranges::size(E))を符号付き整数型にした型とptrdiff_tのうち、幅の広い方の型である。

戻り値

Rangeの要素数。

カスタマイゼーションポイント

ranges::sizeをカスタマイズすることで、ranges::ssizeをカスタマイズできる。

例

#include <cassert>
#include <vector>
#include <ranges>

int main()
{
  std::vector<int> v = {1, 2, 3};
  int ar[] = {1, 2, 3};

  // コンテナの要素数を取得。
  std::ptrdiff_t n1 = std::ranges::ssize(v);
  assert(n1 == 3);

  // 生配列の要素数を取得
  std::ptrdiff_t n2 = std::ranges::ssize(ar);
  assert(n2 == 3);
}

• std::ranges::ssize[color ff0000]
• std::ptrdiff_t[link /reference/cstddef/ptrdiff_t.md]

出力

バージョン

言語

• C++20

処理系

• Clang: 13.0.0 [mark verified]
• GCC: 10.1.0 [mark verified]
• ICC: ?
• Visual C++: 2019 Update 10 [mark verified]

関連項目

• std::ssize

参照

• N4861 24 Ranges library
• C++20 ranges
• LWG Issue 3403. Domain of ranges::ssize(E) doesn't match ranges::size(E)
  • C++23で、ranges::ssizeの定義がdecltype(ranges::size(E))ベースに書き換えられ、ranges::sizeが有効ならranges::ssizeも有効となるようドメインが一致された