std::basic_string<CharT,Traits,Allocator>::size, std::basic_string<CharT,Traits,Allocator>::length — cppreference.com

Материал из cppreference.com

	(1)
`size_type size() const;`			(до C++11)
`size_type size() const noexcept;`			(начиная с C++11) (до C++20)
`constexpr size_type size() const noexcept;`			(начиная с C++20)
		(2)
`size_type length() const;`				(до C++11)
`size_type length() const noexcept;`				(начиная с C++11) (до C++20)
`constexpr size_type length() const noexcept;`				(начиная с C++20)

Возвращает количество элементов CharT в строке, т.е. std::distance(begin(), end()).

Параметры

(нет)

Возвращаемое значение

Количество элементов 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()); // 8 кодовых точек в UTF-32

    std::u16string b(u"ハロー・ワールド"); // 8 кодовых точек
    assert(8 == b.size()); // 8 кодовых точек в UTF-16

    std::string c("ハロー・ワールド"); // 8 кодовых точек
    assert(24 == c.size()); // 24 кодовых точек в UTF-8

    #if __cplusplus >= 202002
    std::u8string d(u8"ハロー・ワールド"); // 8 кодовых точек
    assert(24 == d.size()); // 24 кодовых точек в UTF-8
    #endif
}

Смотрите также

	проверяет, пуста ли строка (public функция-элемент) [править]
	возвращает максимальное количество символов (public функция-элемент) [править]
	возвращает количество символов (public функция-элемент `std::basic_string_view<CharT,Traits>`) [править]

Категории: