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 */);

Trouve la dernière sous-chaîne égale à la séquence de caractères donnée. La recherche commence à pos et progresse de droite à gauche (ainsi, la sous-chaîne trouvée, si elle existe, ne peut pas commencer à une position après pos). Si npos ou toute valeur non inférieure à size()- 1 est passée comme pos, la chaîne entière est recherchée.

Dans tous les cas, l'égalité est vérifiée en appelant Traits::eq.

Paramètres

Valeur de retour

Position du premier caractère de la sous-chaîne trouvée ou npos si aucune sous-chaîne de ce type n'est trouvée. Notez qu'il s'agit d'un décalage depuis le début de la chaîne, et non depuis la fin.

Si on recherche une chaîne vide (c'est-à-dire, str. size ( ) , count , ou Traits :: length ( s ) vaut zéro), la chaîne vide est trouvée immédiatement et rfind retourne :

• pos , si pos < size ( ) ;
• size ( ) sinon, y compris le cas où pos == npos .

Sinon, si size() est zéro, npos est toujours retourné.

Exceptions

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( garantie forte de sûreté face aux exceptions ).

Exemple

#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";
    // recherche en arrière depuis la fin de la chaîne
    n = s.rfind("is");
    print(n, 2, s);
    // recherche en arrière depuis la position 4
    n = s.rfind("is", 4);
    print(n, 2, s);
    // trouver un caractère unique
    n = s.rfind('s');
    print(n, 1, s);
    // trouver un caractère unique
    n = s.rfind('q');
    print(n, 1, s);
    // trouver le préfixe (voir aussi 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

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi