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

 

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 bool starts_with( basic_string_view sv ) const noexcept;	(1)	(seit C++20)
constexpr bool starts_with( CharT ch ) const noexcept;	(2)	(seit C++20)
constexpr bool starts_with( const CharT* s ) const;	(3)	(seit C++20)

Prüft, ob die String-Ansicht mit dem gegebenen Präfix beginnt, wobei

1) das Präfix eine String-Ansicht ist. Gibt effektiv zurück basic_string_view(data(), std::min(size(), sv.size())) == sv.

2) das Präfix ein einzelnes Zeichen ist. Gibt effektiv zurück !empty() && Traits::eq(front(), ch).

3) das Präfix eine nullterminierte Zeichenkette ist. Gibt effektiv zurück starts_with(basic_string_view(s)).

Parameter

sv	-	eine String-Ansicht, die möglicherweise ein Ergebnis der impliziten Konvertierung aus std::basic_string ist
ch	-	Ein einzelnes Zeichen.
s	-	Ein null-terminierter Zeichenstring.

Rückgabewert

true, wenn die String-Ansicht mit dem angegebenen Präfix beginnt, andernfalls false.

Anmerkungen

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_starts_ends_with	201711L	(C++20)	Prüfung von String-Präfixen und -Suffixen: starts_with() und ends_with()

Beispiel

Führen Sie diesen Code aus

#include <cassert>
#include <string_view>
 
int main()
{
    using namespace std::literals;
 
    assert
    (""
        // (1) starts_with( basic_string_view )
        && "https://cppreference.de"sv.starts_with("http"sv) == true
        && "https://cppreference.de"sv.starts_with("ftp"sv) == false
 
        // (2) starts_with( CharT )
        && "C++20"sv.starts_with('C') == true
        && "C++20"sv.starts_with('J') == false
 
        // (3) starts_with( const CharT* )
        && std::string_view("string_view").starts_with("string") == true
        && std::string_view("string_view").starts_with("String") == false
    );
}

Siehe auch

ends_with (C++20)	prüft, ob die Zeichenansicht mit dem gegebenen Suffix endet (öffentliche Member-Funktion)
starts_with (C++20)	prüft, ob der String mit dem gegebenen Präfix beginnt (öffentliche Memberfunktion von std::basic_string<CharT,Traits,Allocator>)
ends_with (C++20)	prüft, ob der String mit dem gegebenen Suffix endet (öffentliche Memberfunktion von std::basic_string<CharT,Traits,Allocator>)
contains (C++23)	prüft, ob der String die gegebene Teilzeichenkette oder das gegebene Zeichen enthält (öffentliche Memberfunktion von std::basic_string<CharT,Traits,Allocator>)
contains (C++23)	prüft, ob die Zeichenansicht die gegebene Teilzeichenkette oder das gegebene Zeichen enthält (öffentliche Member-Funktion)
compare	vergleicht zwei Ansichten (öffentliche Member-Funktion)