std::basic_string<CharT,Traits,Allocator>::find

 

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)

 

size_type find( const basic_string& str, size_type pos = 0 ) const;	(1)	(noexcept seit C++11) (constexpr seit C++20)
size_type find( const CharT* s, size_type pos, size_type count ) const;	(2)	(constexpr seit C++20)
size_type find( const CharT* s, size_type pos = 0 ) const;	(3)	(constexpr seit C++20)
size_type find( CharT ch, size_type pos = 0 ) const;	(4)	(noexcept seit C++11) (constexpr seit C++20)
template< class StringViewLike > size_type find( const StringViewLike& t,                 size_type pos = 0 ) const noexcept(/* siehe unten */);	(5)	(seit C++17) (constexpr seit C++20)

Sucht die erste Teilzeichenkette, die mit der gegebenen Zeichensequenz übereinstimmt. Die Suche beginnt bei Position pos, d.h. die gefundene Teilzeichenkette darf nicht an einer Position davor beginnen.

1) Sucht die erste Teilzeichenkette, die mit str übereinstimmt.

2) Sucht die erste Teilzeichenkette, die mit dem Bereich [s, s + count) übereinstimmt. Dieser Bereich darf Nullzeichen enthalten.

Wenn [s, s + count) kein gültiger Bereich ist, ist das Verhalten undefiniert.

3) Sucht die erste Teilzeichenkette, die mit der von s zeigenden Zeichenkette übereinstimmt. Die Länge der Zeichenkette wird durch das erste Nullzeichen mittels Traits::length(s) bestimmt.

Wenn [s, s + Traits::length(s)) kein gültiger Bereich ist, ist das Verhalten undefiniert.

4) Sucht das erste Zeichen ch (das gemäß den formalen Regeln unten als Teilzeichenkette der Länge eins behandelt wird).

5) Konvertiert t implizit in eine String-Ansicht sv, als ob durch std::basic_string_view<CharT, Traits> sv = t;, und sucht dann die erste Teilzeichenkette, die mit sv übereinstimmt.

Dieser Überladungsschlüssel nimmt nur an der Überladungsauflösung teil, wenn std::is_convertible_v<const StringViewLike&,
                      std::basic_string_view<CharT, Traits>> true ist und std::is_convertible_v<const StringViewLike&, const CharT*> false ist.

Formal ausgedrückt wird eine Teilzeichenkette str an der Position xpos als *gefunden* bezeichnet, wenn alle folgenden Bedingungen erfüllt sind:

• xpos >= pos
• xpos + str.size() <= size()
• für alle Positionen n in str gilt: Traits::eq(at(xpos + n), str.at(n)).

Insbesondere impliziert dies, dass

• eine Teilzeichenkette nur gefunden werden kann, wenn pos <= size() - str.size()
• eine leere Teilzeichenkette an Position pos gefunden wird, wenn und nur wenn pos <= size()
• für eine nicht-leere Teilzeichenkette gilt: Wenn pos >= size(), gibt die Funktion immer npos zurück.

Parameter

str	-	Zu durchsuchende Zeichenkette
pos	-	Position, an der die Suche beginnen soll
zählt	-	Länge der zu durchsuchenden Teilzeichenkette
s	-	Zeiger auf eine zu durchsuchende Zeichenkette
ch	-	Zu durchsuchendes Zeichen
t	-	Zu durchsuchendes Objekt (konvertierbar in std::basic_string_view)

Rückgabewert

Position des ersten Zeichens der gefundenen Teilzeichenkette oder npos, wenn keine solche Teilzeichenkette gefunden wird.

Ausnahmen

1,4) Wirft nichts.

5)

noexcept-Spezifikation:  

noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)

Wenn aus irgendeinem Grund eine Ausnahme ausgelöst wird, hat diese Funktion keine Auswirkungen (starkes Ausnahmesicherheitsgarantie).

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
#include <string>
 
void print(int id, std::string::size_type n, std::string const& s)
{
    std::cout << id << ") ";
    if (std::string::npos == n)
        std::cout << "not found! n == npos\n";
    else
        std::cout << "found @ n = " << n << ", substr(" << n << ") = "
                  << std::quoted(s.substr(n)) << '\n';
}
 
int main()
{
    std::string::size_type n;
    std::string const s = "This is a string"; /*
                             ^  ^  ^
                             1  2  3          */
 
    // search from beginning of string
    n = s.find("is");
    print(1, n, s);
 
    // search from position 5
    n = s.find("is", 5);
    print(2, n, s);
 
    // find a single character
    n = s.find('a');
    print(3, n, s);
 
    // find a single character
    n = s.find('q');
    print(4, n, s);
}

Ausgabe

1) found @ n = 2, substr(2) = "is is a string"
2) found @ n = 5, substr(5) = "is a string"
3) found @ n = 8, substr(8) = "a string"
4) not found! n == npos

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 847	C++98	Es gab keine Ausnahmesicherheitsgarantie	starke Ausnahmesicherheitsgarantie hinzugefügt
LWG 2064	C++11	Überladungen (3,4) waren noexcept	entfernt
LWG 2946	C++17	Überladung (5) verursachte Mehrdeutigkeiten in einigen Fällen	vermieden durch die Erstellung als Template
P1148R0	C++11 C++17	noexcept für Überladungen (4,5) waren versehentlich von LWG2064/LWG2946 fallen gelassen	wiederhergestellt

Siehe auch

strstr	findet das erste Vorkommen eines Teilstrings von Zeichen (Funktion)
wcsstr	findet das erste Vorkommen einer breiten Zeichenkette innerhalb einer anderen breiten Zeichenkette (Funktion)
strchr	findet das erste Vorkommen eines Zeichens (Funktion)
wcschr	findet das erste Vorkommen eines breiten Zeichens in einer breiten Zeichenkette (Funktion)
rfind	sucht das letzte Vorkommen einer Teilzeichenkette (public member function)
find_first_of	findet das erste Vorkommen von Zeichen (public member function)
find_first_not_of	findet das erste Fehlen von Zeichen (public member function)
find_last_of	findet das letzte Vorkommen von Zeichen (public member function)
find_last_not_of	findet das letzte Fehlen von Zeichen (public member function)
find	sucht Zeichen in der Ansicht (public member function of std::basic_string_view<CharT,Traits>)
search	Sucht nach dem ersten Vorkommen eines Elementbereichs (Funktionstempelat)