GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • cpprefjp - C++日本語リファレンス
  • GitHub Project

This view

  • Original page
  • New address

GeezerVison is showing cpprefjp.github.io — std::ssize - cpprefjp C++日本語リファレンス

  1. リファレンス
  2. iterator
  3. ssize

最終更新日時: 2026年08月27日 16時26分21秒 (JST)
Akira Takahashi が更新

履歴 編集

function template
<iterator>

std::ssize(C++20)

namespace std {
  template <class C>
  constexpr auto
    ssize(const C& c)
      -> common_type_t<ptrdiff_t, make_signed_t<decltype(c.size())>>;  // (1) C++20
  template <class C>
  constexpr auto
    ssize(const C& c)
      noexcept(noexcept(c.size()))
      -> common_type_t<ptrdiff_t, make_signed_t<decltype(c.size())>>;  // (1) C++26

  template <class T, ptrdiff_t N>
  constexpr ptrdiff_t
    ssize(const T (&array)[N]) noexcept;                               // (2) C++20
}

概要

コンテナの要素数を、符号付き整数型で取得する。

  • (1) : コンテナの要素数を取得する
  • (2) : 生配列の要素数を取得する

この関数の戻り値は、標準コンテナも含めて基本的にはstd::ptrdiff_t型が返る。ただし、自作コンテナのsize()メンバ関数がstd::size_tと異なる幅の型を返す場合は、それに対応する符号付き整数型が返る。

戻り値

  • (1) : return c.size();
  • (2) : return N;

備考

  • <iterator>ヘッダを読み込む以外では、以下のヘッダが読み込まれている場合に、この関数を使用できる:
    • <array>
    • <deque>
    • <flat_map> (C++26)
    • <flat_set> (C++26)
    • <forward_list>
    • <hive> (C++26)
    • <inplace_vector> (C++26)
    • <list>
    • <map>
    • <regex>
    • <set>
    • <simd> (C++29)
    • <span> (C++20)
    • <string>
    • <string_view> (C++20)
    • <unordered_map>
    • <unordered_set>
    • <vector>

例

#include <cassert>
#include <vector>
#include <iterator>

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

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

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

出力

バージョン

言語

  • C++20

処理系

  • Clang: 9.0 ✅
  • GCC: 12.3.0 ✅
  • Visual C++: ??

関連項目

  • C++23 (符号付き)size_tリテラルのためのサフィックス
  • std::cmp_less()

参照

  • P1227: Signed ssize() functions, unsigned size() functions (Revision 2)
  • P3016R6 Resolve inconsistencies in begin/end for valarray and braced-initializer-list
  • LWG Issue 4385. Including <simd> doesn't provide std::begin/end
    • この関数テンプレートが利用可能になるヘッダの一覧に<simd>が追加された。規格としてはC++29のワーキングドラフトへ適用されたが、<simd>が追加されたC++26で記載が漏れていたものであるため、C++26へ遡及して適用される
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.