Namespaces
Variants

std::basic_string<CharT,Traits,Allocator>::size, std::basic_string<CharT,Traits,Allocator>::length

ja.cppreference.net より
 
 
 
std::basic_string
 
size_type size() const;
(1) (C++11からnoexcept)
(C++20からconstexpr)
size_type length() const;
(2) (C++11からnoexcept)
(C++20からconstexpr)

文字列内のCharTCharT型要素の数、すなわち std::distance(begin(), end())std::basic_string::size_type

パラメータ

(なし)

戻り値

文字列内の CharT 要素の数。

計算量

未規定

(C++11まで)

定数

(C++11以降)

注記

std::string の場合、要素はバイト( char 型のオブジェクト)であり、UTF-8のようなマルチバイトエンコーディングが使用される場合、これは文字と同じではありません。

例

#include <cassert>
#include <iterator>
#include <string>
int main()
{
    std::string s("Exemplar");
    assert(8 == s.size());
    assert(s.size() == s.length());
    assert(s.size() == static_cast<std::string::size_type>(
        std::distance(s.begin(), s.end())));
    std::u32string a(U"ハロー・ワールド"); // 8 コードポイント
    assert(8 == a.size()); // UTF-32 では 8 コード単位
    std::u16string b(u"ハロー・ワールド"); // 8 コードポイント
    assert(8 == b.size()); // UTF-16 では 8 コード単位
    std::string c("ハロー・ワールド"); // 8 コードポイント
    assert(24 == c.size()); // UTF-8 では 24 コード単位
    #if __cpp_lib_char8_t >= 201907L
    std::u8string d(u8"ハロー・ワールド"); // 8 コードポイント
    assert(24 == d.size()); // UTF-8 では 24 コード単位
    #endif
}

関連項目

文字列が空かどうかをチェックする
(public member function)
最大文字数を返す
(public member function)
文字数を返す
(std::basic_string_view<CharT,Traits>の public member function)