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

 

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

Prüft, ob die Zeichenkette die gegebene Teilzeichenkette enthält, wobei

1) die Teilzeichenkette eine Zeichenkettenansicht ist.

2) die Teilzeichenkette ein einzelnes Zeichen ist.

3) die Teilzeichenkette eine nullterminierte Zeichenkette ist.

Alle drei Überladungen sind äquivalent zu return find(x) != npos;, wobei x der Parameter ist.

Parameter

sv	-	eine Zeichenkettenansicht
c	-	Ein einzelnes Zeichen.
s	-	Ein null-terminierter Zeichenstring.

Rückgabewert

true, wenn die Zeichenkettenansicht die übergebene Teilzeichenkette enthält, false andernfalls.

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_string_contains	202011L	(C++23)	contains Funktionen

Beispiel

Führen Sie diesen Code aus

#include <string_view>
using namespace std::literals;
 
static_assert
(
    // bool contains(basic_string_view x) const noexcept;
    "https://cppreference.de"sv.contains("cpp"sv) == true and
    "https://cppreference.de"sv.contains("php"sv) == false and
 
    // bool contains(CharT x) const noexcept;
    "C++23"sv.contains('+') == true and
    "C++23"sv.contains('-') == false and
 
    // bool contains(const CharT* x) const;
    std::string_view("basic_string_view").contains("string") == true and
    std::string_view("basic_string_view").contains("String") == false
);
 
int main() {}

Siehe auch

starts_with (C++20)	prüft, ob die Zeichenansicht mit dem gegebenen Präfix beginnt (öffentliche Member-Funktion)
ends_with (C++20)	prüft, ob die Zeichenansicht mit dem gegebenen Suffix endet (öffentliche Member-Funktion)
find	sucht Zeichen in der Ansicht (öffentliche Member-Funktion)
substr	gibt eine Teilzeichenkette zurück (öffentliche Member-Funktion)
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>)