std::basic_string::compare

 

C++

Sprache

Concepts

Utilities-Bibliothek

Strings Bibliothek

Container-Bibliothek

Algorithmen-Bibliothek

Iteratoren Bibliothek

Numerik-Bibliothek

Input / Output-Bibliothek

Lokalisierungen Bibliothek

Reguläre Ausdrücke Bibliothek(C++11)

Atomare Operationen Bibliothek(C++11)

Thread Support-Bibliothek(C++11)

 

Strings Bibliothek

Null-terminierte Strings Original: Null-terminated strings The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Byte-Strings

Multibyte-Strings

Wide Strings

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

basic_string

char_traits

 

std::basic_string

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

basic_string::basic_string

basic_string::operator=

basic_string::assign

basic_string::get_allocator

Elementzugriff zerstört Original: Element access The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string::at

basic_string::operator[]

basic_string::front (C++11)

basic_string::back (C++11)

basic_string::data

basic_string::c_str

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

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)

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

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)

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

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::replace

basic_string::substr

basic_string::copy

basic_string::resize

basic_string::swap

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

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

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

basic_string::npos

Non-Member-Funktionen Original: Non-member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

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)

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

hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> (C++11)

 

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 )constnoexcept;	(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)

Vergleicht zwei Zeichenfolgen .

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)

Vergleicht diese Zeichenfolge str. Zuerst berechnet die Anzahl der Zeichen zu vergleichen, als ob durch size_type rlen =std::min(size(), str.size()). Dann vergleicht indem Traits::compare(data(), str.data(), rlen). Für Standard-Strings diese Funktion führt Charakter-Charakter lexikographische Vergleich. Wenn das Ergebnis Null ist (die Saiten gleich sind bisher), dann ihre Größen sind wie folgt verglichen:

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)

Vergleicht einen [pos1, pos1+count1) Teilzeichenfolge dieser Zeichenfolge str wie von 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)

Vergleicht einen [pos1, pos1+count1) Teilzeichenfolge dieser String in einen Teilstring [pos2, pas2+count2) von str wie von 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)

Vergleicht diese Zeichenfolge an den null-terminierte Zeichenfolge Beginn auf den Charakter, auf die s, als ob durch compare(basic_string(s))

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)

Vergleicht einen [pos1, pos1+count1) Teilzeichenfolge dieser Zeichenfolge an den null-terminierte Zeichenfolge Beginn auf den Charakter, auf die s, als ob durch 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)

Vergleicht einen [pos1, pos1+count1) Teilzeichenfolge dieser String in der ersten count2 Zeichen des Zeichen-Array, dessen erstes Zeichen wird durch s hingewiesen, als ob durch basic_string(*this, pos, count1).compare(basic_string(s, count2)). (Hinweis: die Zeichen aus s um s+count2 kann NULL-Zeichen enthalten))

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.

Parameter

str	-	anderen Zeichenfolge zu vergleichen 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	-	Zeiger auf die Zeichenfolge zu vergleichen 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	-	Anzahl der Zeichen dieser Zeichenfolge 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	-	Position des ersten Zeichens in dieser Zeichenfolge zu vergleichen 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	-	Anzahl der Zeichen des angegebenen String 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	-	Position des ersten Zeichens eines gegebenen Strings zu vergleichen 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.

Rückgabewert

negativen Wert, wenn diese Zeichenfolge ist weniger als die andere Zeichenfolge, Null, wenn die beiden Zeichenfolgen gleich, positiven Wert sind, wenn diese Zeichenfolge ist mehr als der andere Zeichenfolge .

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.

Ausnahmen

1)

noexcept specification:  

noexcept

  (seit C++11)

2-6)

Können die Ausnahmen von den entsprechenden basic_string Konstruktoren geworfen werfen .

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.

Mögliche Implementierung

template<class CharT, class Traits, class Alloc>int basic_string<CharT, Traits, Alloc>::compare(conststd::basic_string& str)constnoexcept{ 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)return1;return0;}

Siehe auch

operator== operator!= operator< operator> operator<= operator>=	vergleicht lexikographisch zwei Strings (Funktions-Template)
substr	liefert einen Teilstring 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. (öffentliche Elementfunktion)
collate	definiert lexikographische Vergleich und Hashing von Strings 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. (Klassen-Template)
strcoll	vergleicht zwei Strings in Übereinstimmung mit dem aktuellen Gebietsschema Original: compares two strings in accordance to the current locale The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (Funktion)