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

Findet die letzte Teilzeichenfolge, die der gegebenen Zeichenfolge entspricht. Die Suche beginnt bei pos und verläuft von rechts nach links (daher kann die gefundene Teilzeichenfolge, falls vorhanden, nicht an einer Position beginnen, die nach pos liegt). Wenn npos oder ein Wert nicht kleiner als size() - 1 als pos übergeben wird, wird die gesamte Zeichenfolge durchsucht.

In allen Fällen wird Gleichheit durch Aufruf von Traits::eq überprüft.

Parameter

Rückgabewert

Position des ersten Zeichens der gefundenen Teilzeichenkette oder npos falls keine solche Teilzeichenkette gefunden wurde. Beachten Sie, dass dies ein Offset vom Anfang der Zeichenkette ist, nicht vom Ende.

Wenn nach einer leeren Zeichenkette gesucht wird (d.h., str. size ( ) , count , oder Traits :: length ( s ) ist null), wird die leere Zeichenkette sofort gefunden und rfind gibt zurück:

• pos , falls pos < size ( ) ;
• size ( ) andernfalls, einschließlich des Falls, in dem pos == npos .

Andernfalls, wenn size() null ist, wird stets npos zurückgegeben.

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(std::string::size_type n,
           std::string::size_type len,
           std::string const &s)
{
    if (n == std::string::npos)
        std::cout << "not found\n";
    else
        std::cout << "found: " << std::quoted(s.substr(n, len)) << " at " << n << '\n';
}
int main()
{
    std::string::size_type n;
    std::string const s = "This is a string";
    // Suche rückwärts vom Ende des Strings
    n = s.rfind("is");
    print(n, 2, s);
    // Suche rückwärts von Position 4
    n = s.rfind("is", 4);
    print(n, 2, s);
    // Finde ein einzelnes Zeichen
    n = s.rfind('s');
    print(n, 1, s);
    // Finde ein einzelnes Zeichen
    n = s.rfind('q');
    print(n, 1, s);
    // Finde das Präfix (siehe auch s.starts_with("This"))
    n = s.rfind("This", 0);
    print(n, 4, s);
}

found: "is" at 5
found: "is" at 2
found: "s" at 10
not found
found: "This" at 0

Fehlerberichte

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

Siehe auch