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

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

メンバ関数 basic_string_view::basic_string_view basic_string_view::operator= イテレータ basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend 要素アクセス basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data 容量 basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty 変更 basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap

操作 basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::starts_with (C++20) basic_string_view::ends_with (C++20) basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of 定数 basic_string_view::npos 非メンバ関数 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20) operator<< operator""sv ヘルパークラス hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) 推定ガイド(C++20)

 

<tbody> </tbody>

ヘッダ <string_view> で定義
template< class CharT, class Traits > constexpr bool operator==( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(1)	(C++17以上)
template< class CharT, class Traits > constexpr bool operator!=( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(2)	(C++17以上) (C++20未満)
template< class CharT, class Traits > constexpr bool operator<( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(3)	(C++17以上) (C++20未満)
template< class CharT, class Traits > constexpr bool operator<=( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(4)	(C++17以上) (C++20未満)
template< class CharT, class Traits > constexpr bool operator>( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(5)	(C++17以上) (C++20未満)
template< class CharT, class Traits > constexpr bool operator>=( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(6)	(C++17以上) (C++20未満)
template< class CharT, class Traits > constexpr /*comp-cat*/ operator<=>( std::basic_string_view<CharT,Traits> lhs, std::basic_string_view<CharT,Traits> rhs ) noexcept;	(7)	(C++20以上)

2つのビューを比較します。

すべての比較は compare() メンバ関数を通して行われます (compare() 自身は Traits::compare() によって定義されます)。

• lhs と rhs のサイズが等しく、 lhs 内のそれぞれの文字が rhs 内の同じ位置の文字と等しければ、2つのビューは等しくなります。

• 順序比較は辞書的に行われます。 比較は std::lexicographical_compare と同等な関数によって行われます。

三方比較演算子の戻り値の型 (/*comp-cat*/) は、存在すれば Traits::comparison_category、そうでなければ std::weak_ordering です。

(C++20以上)

実装は、 basic_string_view<CharT,Traits> 型のオブジェクト sv が basic_string_view<CharT,Traits> への暗黙に変換を持つ別のオブジェクト t と比較できるように、 sv と basic_string_view<CharT,Traits>(t) を比較するのと同一のセマンティクスを持つ、これらの関数の充分な追加の constexpr および noexcept オーバーロードを提供しなければなりません。

引数

lhs, rhs

-

比較するビュー

戻り値

1-6) 対応する比較が成立すれば true、そうでなければ false。

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

ノート

充分な追加のオーバーロードは、1つの引数における非推定文脈で実装できます。

std::string_view、 std::wstring_view、 std::u8string_view、 std::u16string_view および std::u32string_view の三方比較の結果の型は std::strong_ordering です。

(C++20以上)

計算量

ビューのサイズに比例。