std::basic_string_view<CharT,Traits>::compare

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

Memberfunktionen basic_string_view::basic_string_view    basic_string_view::operator= Iteratoren 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 Kapazität basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty Operationen 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::contains (C++23) 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

Elementzugriff basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data Modifizierer basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap Konstanten basic_string_view::npos Nicht-Member-Funktionen operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) operator<< operator""sv Hilfsklassen hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) Leitfäden zur Deduktion (C++20)

 

constexpr int compare( basic_string_view v ) const noexcept;	(1)	(seit C++17)
constexpr int compare( size_type pos1, size_type count1,                        basic_string_view v ) const;	(2)	(seit C++17)
constexpr int compare( size_type pos1, size_type count1, basic_string_view v,                        size_type pos2, size_type count2 ) const;	(3)	(seit C++17)
constexpr int compare( const CharT* s ) const;	(4)	(seit C++17)
constexpr int compare( size_type pos1, size_type count1,                        constexpr int compare( const CharT* s, size_type count2 ) const;	(5)	(seit C++17)
constexpr int compare( size_type pos1, size_type count1,                        constexpr int compare( size_type pos1, size_type count1, const CharT* s, size_type count2 ) const;	(6)	(seit C++17)

Vergleicht zwei Zeichensequenzen.

1) Die Länge rlen der zu vergleichenden Sequenzen ist das Minimum von size() und v.size(). Die Funktion vergleicht die beiden Views durch Aufruf von traits::compare(data(), v.data(), rlen) und gibt einen Wert gemäß der folgenden Tabelle zurück

Bedingung		Ergebnis	Rückgabewert
Traits::compare(data(), v.data(), rlen) < 0		this ist kleiner als v	< 0
Traits::compare(data(), v.data(), rlen) == 0	size() < v.size()	this ist kleiner als v	< 0
	size() == v.size()	this ist gleich wie v	​0​
	size() > v.size()	this ist größer als v	> 0
Traits::compare(data(), v.data(), rlen) > 0		this ist größer als v	> 0

2) Entspricht substr(pos1, count1).compare(v).

3) Entspricht substr(pos1, count1).compare(v.substr(pos2, count2)).

4) Entspricht compare(basic_string_view(s)).

5) Entspricht substr(pos1, count1).compare(basic_string_view(s)).

6) Entspricht substr(pos1, count1).compare(basic_string_view(s, count2)).

Parameter

v	-	zu vergleichender View
s	-	Zeiger auf die zu vergleichende Zeichenkette
count1	-	Anzahl der Zeichen dieses Views, die verglichen werden sollen
pos1	-	Position des ersten zu vergleichenden Zeichens in diesem View
count2	-	Anzahl der Zeichen des gegebenen Views, die verglichen werden sollen
pos2	-	Position des ersten Zeichens des gegebenen Views, das verglichen werden soll

Rückgabewert

Negativer Wert, wenn dieser View kleiner ist als die andere Zeichensequenz, Null, wenn beide Zeichensequenzen gleich sind, positiver Wert, wenn dieser View größer ist als die andere Zeichensequenz.

Komplexität

1) Linear zur Anzahl der verglichenen Zeichen.

Beispiel

Führen Sie diesen Code aus

#include <string_view>
 
int main()
{
    using std::operator""sv;
    static_assert("abc"sv.compare("abcd"sv) < 0);
    static_assert("abcd"sv.compare("abc"sv) > 0);
    static_assert("abc"sv.compare("abc"sv) == 0);
    static_assert(""sv.compare(""sv) == 0);
}

Siehe auch

compare	vergleicht zwei Strings (public member function of std::basic_string<CharT,Traits,Allocator>)
operator==operator!=operator<operator>operator<=operator>=operator<=> (C++17)(entfernt in C++20)(entfernt in C++20)(entfernt in C++20)(entfernt in C++20)(entfernt in C++20)(C++20)	vergleicht zwei Zeichenansichten lexikographisch (Funktionsschablone)