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

Encuentra la última subcadena que es igual a la secuencia de caracteres dada. La búsqueda comienza en pos y procede de derecha a izquierda (por lo tanto, la subcadena encontrada, si existe, no puede comenzar en una posición posterior a pos ). Si se pasa npos o cualquier valor no menor que size() - 1 como pos , se buscará en toda la cadena.

En todos los casos, la igualdad se verifica llamando a Traits::eq .

Parámetros

Valor de retorno

Posición del primer carácter de la subcadena encontrada o npos si no se encuentra dicha subcadena. Nótese que este es un desplazamiento desde el inicio de la cadena, no desde el final.

Si se busca una cadena vacía (es decir, str. size ( ) , count , o Traits :: length ( s ) es cero), la cadena vacía se encuentra inmediatamente y rfind devuelve:

• pos , si pos < size ( ) ;
• size ( ) en caso contrario, incluyendo el caso donde pos == npos .

De lo contrario, si size() es cero, npos siempre se devuelve.

Excepciones

Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).

Ejemplo

#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";
    // búsqueda hacia atrás desde el final de la cadena
    n = s.rfind("is");
    print(n, 2, s);
    // búsqueda hacia atrás desde la posición 4
    n = s.rfind("is", 4);
    print(n, 2, s);
    // encontrar un solo carácter
    n = s.rfind('s');
    print(n, 1, s);
    // encontrar un solo carácter
    n = s.rfind('q');
    print(n, 1, s);
    // encontrar el prefijo (ver también 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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también