名前空間
変種
操作

std::size, std::ssize

提供: cppreference.com
< cpp‎ | iterator
 
 
イテレータライブラリ
イテレータコンセプト
イテレータプリミティブ
アルゴリズムのコンセプトとユーティリティ
間接呼び出し可能コンセプト
共通アルゴリズム要件
ユーティリティ
イテレータアダプタ
ストリームイテレータ
イテレータのカスタマイゼーションポイント
イテレータ操作
(C++11)
(C++11)
範囲アクセス
(C++11)(C++14)
(C++11)(C++14)
sizessize
(C++17)(C++20)
(C++14)(C++14)
(C++14)(C++14)
(C++17)
(C++17)
 
ヘッダ <iterator> で定義
template <class C>
constexpr auto size(const C& c) -> decltype(c.size());
(1) (C++17以上)
template <class C>

constexpr auto ssize(const C& c)
    -> std::common_type_t<std::ptrdiff_t,

                          std::make_signed_t<decltype(c.size())>>;
(2) (C++20以上)
template <class T, std::size_t N>
constexpr std::size_t size(const T (&array)[N]) noexcept;
(3) (C++17以上)
template <class T, std::ptrdiff_t N>
constexpr std::ptrdiff_t ssize(const T (&array)[N]) noexcept;
(4) (C++20以上)

指定されたコンテナ c または配列 array のサイズを返します。

1-2) c.size() を返します。 必要な場合は戻り値の型に変換されます。
3-4) N を返します。

目次

[編集] 引数

c - メンバ関数 size を持つコンテナ
array - 任意の型の配列

[編集] 戻り値

c または array のサイズ。

[編集] ノート

<iterator> がインクルードされた場合に加えて <array><deque><forward_list><list><map><regex><set><span> (C++20以上)<string><string_view><unordered_map><unordered_set><vector> のいずれかのヘッダがインクルードされた場合も、 std::size および std::ssize が利用可能になることが保証されています。

[編集] 実装例

1つめのバージョン
template <class C> 
constexpr auto size(const C& c) -> decltype(c.size())
{
    return c.size();
}
2つめのバージョン
template <class C>
constexpr auto ssize(const C& c) 
    -> std::common_type_t<std::ptrdiff_t,
                          std::make_signed_t<decltype(c.size())>> 
{
    using R = std::common_type_t<std::ptrdiff_t,
                                 std::make_signed_t<decltype(c.size())>>;
    return static_cast<R>(c.size());
}
3つめのバージョン
template <class T, std::size_t N>
constexpr std::size_t size(const T (&array)[N]) noexcept
{
    return N;
}
4つめのバージョン
template <class T, std::ptrdiff_t N>
constexpr std::ptrdiff_t ssize(const T (&array)[N]) noexcept
{
    return N;
}

[編集]

#include <iostream>
#include <vector>
#include <iterator>
 
int main() 
{
    std::vector<int> v = { 3, 1, 4 };
    std::cout << std::size(v) << '\n'; 
 
    int a[] = { -5, 10, 15 };
    std::cout << std::size(a) << '\n';
}

出力:

3
3