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

Findet die erste Teilzeichenfolge, die der gegebenen Zeichenfolge entspricht. Die Suche beginnt bei pos , d.h. die gefundene Teilzeichenfolge darf nicht an einer Position vor pos beginnen.

Formal wird eine Teilzeichenkette str an Position xpos als gefunden bezeichnet, wenn alle folgenden Bedingungen true sind:

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

Dies impliziert insbesondere, dass

• Eine Teilzeichenfolge kann nur gefunden werden, wenn pos <= size ( ) - str. size ( )
• Eine leere Teilzeichenfolge wird an Position pos gefunden, genau dann wenn pos <= size ( )
• Für eine nicht-leere Teilzeichenfolge gilt: wenn pos >= size ( ) , gibt die Funktion immer npos zurück.

Parameter

Rückgabewert

Position des ersten Zeichens der gefundenen Teilzeichenkette oder npos falls keine solche Teilzeichenkette gefunden wurde.

Ausnahmen

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).

Beispiel

#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          */
    // Suche vom Anfang des Strings
    n = s.find("is");
    print(1, n, s);
    // Suche ab Position 5
    n = s.find("is", 5);
    print(2, n, s);
    // Einzelnes Zeichen suchen
    n = s.find('a');
    print(3, n, s);
    // Einzelnes Zeichen suchen
    n = s.find('q');
    print(4, n, s);
}

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.

Siehe auch