std::basic_string::compare

 

C++

言語

ヘッダ

コンセプト

言語サポートライブラリ

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

アルゴリズムライブラリ

イテレータライブラリ

数値演算ライブラリ

入出力ライブラリ

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

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

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

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

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

技術仕様書

 

文字列ライブラリ

NULL終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

メンバ関数 basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator 要素アクセス basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) イテレータ basic_string::begin basic_string::cbegin (C++11) basic_string::end basic_string::cend (C++11) basic_string::rbegin basic_string::crbegin (C++11) basic_string::rend basic_string::crend (C++11) 容量 basic_string::empty basic_string::size basic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

操作 basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap 検索 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

非メンバ関数 operator+ operator== operator!= operator< operator> operator<= operator>= swap(std::basic_string) operator<< operator>> getline stoi stol stoll (C++11) (C++11) (C++11) stoul stoull (C++11) (C++11) stof stod stold (C++11) (C++11) (C++11) to_string (C++11) to_wstring (C++11) operator""s (C++14) ヘルパークラス hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> (C++11) (C++11) (C++11) (C++11) hash<std::pmr::string> hash<std::pmr::wstring> hash<std::pmr::u32string> hash<std::pmr::u16string> (C++20) (C++20) (C++20) (C++20) 推定ガイド(C++17)

 

int compare( const basic_string& str ) const;	(1)
int compare( size_type pos1, size_type count1,              const basic_string& str ) const;	(2)
int compare( size_type pos1, size_type count1,              const basic_string& str,              size_type pos2, size_type count2 ) const;	(3)
int compare( const CharT* s ) const noexcept;	(4)
int compare( size_type pos1, size_type count1,              const CharT* s ) const;	(5)
int compare( size_type pos1, size_type count1,              const CharT* s, size_type count2 ) const;	(6)

2つの文字シーケンスを比較.

Original:

Compares two character sequences.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

1)

のstrにこの文字列を比較します。まず、size_type rlen = std::min(size(), str.size())の場合と同様にして、比較する文字の数を計算します。その後Traits::compare(data(), str.data(), rlen)を呼び出して比較します。標準の文字列の場合、この関数は、文字ごとに比較を辞書式が実行されます。結果がゼロ（文字列がこれまでに等しい）である場合、それらのサイズは以下のように比較されます

Original:

Compares this string to str. First, calculates the number of characters to compare, as if by size_type rlen = std::min(size(), str.size()). Then compares by calling Traits::compare(data(), str.data(), rlen). For standard strings this function performs character-by-character lexicographical comparison. If the result is zero (the strings are equal so far), then their sizes are compared as follows:

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Condition		Result	Return value
Traits::compare(data, arg, rlen) < 0		data is less than arg	<0
Traits::compare(data, arg, rlen) == 0	size(data) < size(arg)	data is less than arg	<0
	size(data) == size(arg)	data is equal to arg	​0​
	size(data) > size(arg)	data is greater than arg	>0
Traits::compare(data, arg, rlen) > 0		data is greater than arg	>0

2)

まるで[pos1, pos1+count1)によって strにこの文字列のbasic_string(*this, pos1, count1).compare(str)の部分文字列を比較します

Original:

Compares a [pos1, pos1+count1) substring of this string to str as if by basic_string(*this, pos1, count1).compare(str)

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

3)

[pos1, pos1+count1) strのまるで[pos2, pas2+count2)により部分文字列にこの文字列のbasic_string(*this, pos1, count1).compare(basic_string(str, pos2, count2))の部分文字列を比較します

Original:

Compares a [pos1, pos1+count1) substring of this string to a substring [pos2, pas2+count2) of str as if by basic_string(*this, pos1, count1).compare(basic_string(str, pos2, count2))

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

4)

としてcompare(basic_string(s))であれば、 'のが指す文字で、NULLで終わる文字シーケンスの先頭にこの文字列を比較します

Original:

Compares this string to the null-terminated character sequence beginning at the character pointed to by s, as if by compare(basic_string(s))

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

5)

として[pos1, pos1+count1)であれば、 'のが指す文字で、NULLで終わる文字シーケンスの先頭にこの文字列のbasic_string(*this, pos, count1).compare(basic_string(s))の部分文字列を比較します

Original:

Compares a [pos1, pos1+count1) substring of this string to the null-terminated character sequence beginning at the character pointed to by s, as if by basic_string(*this, pos, count1).compare(basic_string(s))

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

6)

）：（[pos1, pos1+count1)へcount2から文字がヌル文字を含めることができます注）最初の文字 'のとしてbasic_string(*this, pos, count1).compare(basic_string(s, count2)).によって場合によって指された文字配列の最初のs文字にこの文字列のs+count2の部分文字列を比較します

Original:

Compares a [pos1, pos1+count1) substring of this string to the first count2 characters of the character array whose first character is pointed to by s, as if by basic_string(*this, pos, count1).compare(basic_string(s, count2)). (Note: the characters from s to s+count2 may include null characters))

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

パラメータ

str	-	と比較するもう一方の文字列 Original: other string to compare to The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
s	-	と比較する文字列へのポインタ Original: pointer to the character string to compare to The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
count1	-	comporeにこの文字列の文字数 Original: number of characters of this string to compore The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
pos1	-	比較するには、この文字列の最初の文字の位置 Original: position of the first character in this string to compare The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
count2	-	comporeに与えられた文字列の文字数 Original: number of characters of the given string to compore The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
pos2	-	比較するために与えられた文字列の最初の文字の位置 Original: position of the first character of the given string to compare The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

値を返します

この文字列が他の文字シーケンスより大きいのであれば両方の文字のシーケンスが等しい正の値である場合、この文字列が他の文字配列よりも少ない'、ゼロの場合は負の値.

Original:

negative value if this string is less than the other character sequence, zero if the both character sequences are equal, positive value if this string is greater than the other character sequence.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

例外

1)

noexcept 指定:  

noexcept

  (C++11およびそれ以降)

2-6)

対応basic_stringコンストラクタによってスローされた例外をスローすることがあります.

Original:

May throw the exceptions thrown by the corresponding basic_string constructors.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

可能な実装

template<class CharT, class Traits, class Alloc> int basic_string<CharT, Traits, Alloc>::compare(const std::basic_string& str) const noexcept { size_type lhs_sz = size(); size_type rhs_sz = str.size(); int result = traits_type::compare(data(), str.data(), std::min(lhs_sz, rhs_sz)); if (result != 0) return result; if (lhs_sz < rhs_sz) return -1; if (lhs_sz > rhs_sz) return 1; return 0; }

参照

operator== operator!= operator< operator> operator<= operator>=	2つの文字列を辞書的に比較します (関数テンプレート)
substr	部分文字列を返します Original: returns a substring The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (パブリックメンバ関数)
collate	文字列の比較とハッシュを辞書式が定義されています Original: defines lexicographical comparison and hashing of strings The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (クラステンプレート)
strcoll	現在のロケールに従って2つの文字列を比較します (関数)