operator==,!=,<,<=,>,>=,<=>(std::basic_string)

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Функции-элементы basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23) basic_string::get_allocator Доступ к элементам basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Итераторы basic_string::beginbasic_string::cbegin (DR*) basic_string::endbasic_string::cend (DR*) basic_string::rbeginbasic_string::crbegin (DR*) basic_string::rendbasic_string::crend (DR*) Ёмкость basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Операции basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::compare basic_string::replace basic_string::replace_with_range (C++23) basic_string::substr basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)   basic_string::swap

Поиск basic_string::starts_with (C++20)   basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Константы basic_string::npos Правила вывода(C++17) Функции, не являющиеся элементами operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) Ввод/Вывод operator<<operator>> getline Сравнение operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20) Числовые преобразования stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11) stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Вспомогательные классы hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)  (C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++17)(C++17)(C++17)(C++17)(C++20)

 

Определено в заголовочном файле <string>

Сравнивает два объекта basic_string

(1)

template<class CharT, class Traits, class Alloc > bool operator==(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++11)

template<class CharT, class Traits, class Alloc > bool operator==(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++11) (до C++20)

template<class CharT, class Traits, class Alloc > constexprbool     operator==(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++20)

(2)

template<class CharT, class Traits, class Alloc > bool operator!=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++11)

template<class CharT, class Traits, class Alloc > bool operator!=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++11) (до C++20)

(3)

template<class CharT, class Traits, class Alloc > bool operator<(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++11)

template<class CharT, class Traits, class Alloc > bool operator<(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++11) (до C++20)

(4)

template<class CharT, class Traits, class Alloc > bool operator<=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++11)

template<class CharT, class Traits, class Alloc > bool operator<=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++11) (до C++20)

(5)

template<class CharT, class Traits, class Alloc > bool operator>(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++11)

template<class CharT, class Traits, class Alloc > bool operator>(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++11) (до C++20)

(6)

template<class CharT, class Traits, class Alloc > bool operator>=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++11)

template<class CharT, class Traits, class Alloc > bool operator>=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(начиная с C++11) (до C++20)

template<class CharT, class Traits, class Alloc > constexpr/*comp-cat*/     operator<=>(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs )noexcept;

(7)

(начиная с C++20)

Сравнивает объект basic_string и массив T, завершающийся нулём

(8)

template<class CharT, class Traits, class Alloc > bool operator==(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  const CharT* rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > constexprbool operator==(conststd::basic_string<CharT,Traits,Alloc>& lhs,                            const CharT* rhs );

(начиная с C++20)

template<class CharT, class Traits, class Alloc > bool operator==(const CharT* lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++20)

(9)

template<class CharT, class Traits, class Alloc > bool operator!=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  const CharT* rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > bool operator!=(const CharT* lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++20)

(10)

template<class CharT, class Traits, class Alloc > bool operator<(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 const CharT* rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > bool operator<(const CharT* lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++20)

(11)

template<class CharT, class Traits, class Alloc > bool operator<=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  const CharT* rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > bool operator<=(const CharT* lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++20)

(12)

template<class CharT, class Traits, class Alloc > bool operator>(conststd::basic_string<CharT,Traits,Alloc>& lhs,                 const CharT* rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > bool operator>(const CharT* lhs,                 conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++20)

(13)

template<class CharT, class Traits, class Alloc > bool operator>=(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  const CharT* rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > bool operator>=(const CharT* lhs,                  conststd::basic_string<CharT,Traits,Alloc>& rhs );

(до C++20)

template<class CharT, class Traits, class Alloc > constexpr/*comp-cat*/     operator<=>(conststd::basic_string<CharT,Traits,Alloc>& lhs,                  const CharT* rhs );

(14)

(начиная с C++20)

Сравнивает содержимое строки с другой строкой или массивом CharT, завершающимся нулём.

Все сравнения выполняются через функцию-элемент compare() (которая сама по себе определяется в терминах Traits::compare()):

• Две строки равны, если размеры lhs и rhs равны и каждый символ в lhs имеет эквивалентный символ в rhs в той же позиции.

• Сравнение выполняется лексикографически — сравнение выполняется функцией, эквивалентной std::lexicographical_compare или std::lexicographical_compare_three_way(начиная с C++20).

1-7) Сравнивает два объекта basic_string.

8-14) Сравнивает объект basic_string и массив CharT, завершающийся нулём.

Тип возвращаемого значения операторов трёхстороннего сравнения (/*comp-cat*/) это Traits::comparison_category, если этот квалифицированный идентификатор существует и обозначает тип, иначе std::weak_ordering. Если /*comp-cat*/ не является типом категории сравнения, программа некорректна. Операторы <, <=, >, >= и !=синтезируются из operator<=> и operator== соответственно.

(начиная с C++20)

Параметры

lhs, rhs

—

строки, содержимое которых нужно сравнить

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

1-6,8-13)true, если соответствующее сравнение выполнено, false иначе.

7,14)static_cast</*comp-cat*/>(lhs.compare(rhs)<=>0).

Сложность

Линейная по размеру строк.

Примечание

Если хотя бы один параметр имеет тип std::string, std::wstring, std::u8string, std::u16string или std::u32string, тип возвращаемого значения operator<=> это std::strong_ordering.

(начиная с C++20)

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 2064	C++11	вопрос о том, являются ли перегрузки, принимающие два basic_string, noexcept, был противоречивым; перегрузки, принимающие CharT*, были noexcept, но могли вызвать неопределённое поведение	сделано последовательным; noexcept удалено
LWG 3432	C++20	тип возвращаемого значения operator<=> не обязательно должен быть типом категории сравнения	требуется