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

size_type rfind( const basic_string& str, size_type pos = npos ) const;

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

size_type rfind( const CharT* s, size_type pos = npos ) const;

size_type rfind( CharT ch, size_type pos = npos ) const;

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

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

In allen Fällen wird die 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