std::basic_string<CharT,Traits,Allocator>::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

Memberfunktionen basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator Elementzugriff basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Iteratoren basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Suche 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

Modifizierer basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap Kapazität basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Operationen basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

Konstanten basic_string::npos Nicht-Member-Funktionen operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline Vergleich operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) Numerische Konvertierungen stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Literale operator""s (C++14) Hilfsklassen hash<std::basic_string> (C++11) Deduction guides (C++17)

 

constexpr bool     contains( std::basic_string_view<CharT,Traits> sv ) const noexcept;	(1)	(seit C++23)
constexpr bool     contains( CharT ch ) const noexcept;	(2)	(seit C++23)
constexpr bool     contains( const CharT* s ) const;	(3)	(seit C++23)

Prüft, ob der String den gegebenen Substring enthält. Der Substring kann einer der folgenden sein:

1) Ein String-View sv (der das Ergebnis einer impliziten Konvertierung von einem anderen std::basic_string sein kann).

2) Ein einzelnes Zeichen ch.

3) Ein null-terminierter Zeichenstring s.

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

Parameter

sv	-	Ein String-View, der das Ergebnis einer impliziten Konvertierung aus einem anderen std::basic_string sein kann.
ch	-	Ein einzelnes Zeichen.
s	-	Ein null-terminierter Zeichenstring.

Rückgabewert

true, wenn der String den bereitgestellten Substring enthält, andernfalls false.

Hinweise

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

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
#include <string>
#include <string_view>
#include <type_traits>
 
template<typename SubstrType>
void test_substring(const std::string& str, SubstrType subs)
{
    constexpr char delim = std::is_scalar_v<SubstrType> ? '\'' : '\"';
    std::cout << std::quoted(str)
              << (str.contains(subs) ? " contains "
                                     : " does not contain ")
              << std::quoted(std::string{subs}, delim) << '\n';
}
 
int main()
{
    using namespace std::literals;
 
    auto helloWorld = "hello world"s;
 
    test_substring(helloWorld, "hello"sv);
    test_substring(helloWorld, "goodbye"sv);
    test_substring(helloWorld, 'w');
    test_substring(helloWorld, 'x');
}

Ausgabe

"hello world" contains "hello"
"hello world" does not contain "goodbye"
"hello world" contains 'w'
"hello world" does not contain 'x'

Siehe auch

starts_with (C++20)	prüft, ob der String mit dem gegebenen Präfix beginnt (public member function)
ends_with (C++20)	prüft, ob der String mit dem gegebenen Suffix endet (public member function)
find	sucht das erste Vorkommen der gegebenen Teilzeichenkette (public member function)
substr	gibt eine Teilzeichenkette zurück (public member function)
contains (C++23)	prüft, ob die Zeichenansicht die gegebene Teilzeichenkette oder das gegebene Zeichen enthält (public member function of std::basic_string_view<CharT,Traits>)