◐ Shell
clean mode source ↗

std::size, std::ssize - cppreference.com

提供: cppreference.com

<tbody> </tbody>

ヘッダ <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';
}

出力: