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

size_type find( const basic_string& str, size_type pos = 0 ) const;

size_type find( const CharT* s, size_type pos, size_type count ) const;

size_type find( const CharT* s, size_type pos = 0 ) const;

size_type find( CharT ch, size_type pos = 0 ) const;

template< class StringViewLike >
size_type find( const StringViewLike& t,
                size_type pos = 0 ) const noexcept(/* see below */);

Findet die erste Teilzeichenkette, die der angegebenen Zeichensequenz entspricht. Die Suche beginnt bei pos, d.h. die gefundene Teilzeichenkette darf nicht an einer Position beginnen, die vor pos liegt.

Formal wird eine Teilzeichenkette str an Position als gefundenxpos bezeichnet, wenn alle folgenden Bedingungen true gilt:

• 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 Teilzeichenkette nur gefunden werden kann, wenn pos <= size() - str.size()
• eine leere Teilzeichenkette bei pos genau dann gefunden wird, wenn pos <= size()
• für eine nicht-leere Teilzeichenkette, die Fall ist, 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