std::basic_string::find

Encuentra la primera subcadena igual a la secuencia de caracteres dada. La búsqueda comienza en pos, p. ej., la subcadena encontrada no debe empezar en una posición que preceda a pos.

Formalmente, una subcadena str se dice que se ha encontrado en la posición xpos si todo lo siguiente es verdadero:

• xpos >= pos ;
• xpos + str.size() <= size();
• para todas las posiciones n in str, Traits::eq(at(xpos+n), str.at(n)).

En particular, esto implica que

• una subcadena puede encontrarse solamente si pos <= size() - str.size();
• una subcadena vacía se encuentra en la posición pos si y solo si pos <= size();
• para una subcadena que no está vacía, si pos >= size(), la función siempre devuelve npos.

[editar] Parámetros

[editar] Valor de retorno

Posición del primer carácter de la subcadena encontrada o npos si no se encontró dicha subcadena.

[editar] Excepciones

[editar] Ejemplo

#include <string>
#include <iostream>
 
void imprime(std::string::size_type n, std::string const &s)
{
    if (n == std::string::npos) {
        std::cout << "no se encuentra\n";
    } else {
        std::cout << "se encuentra: " << s.substr(n) << '\n';
    }
}
 
int main()
{
    std::string::size_type n;
    std::string const s = "esto es una cadena";
 
    // buscar desde el principio de la cadena
    n = s.find("es");
    imprime(n, s);
 
    // buscar desde la posición 5
    n = s.find("es", 5);
    imprime(n, s);
 
    // encuentra un solo carácter
    n = s.find('c');
    imprime(n, s);
 
    // encuentra un solo carácter
    n = s.find('q');
    imprime(n, s);
}

se encuentra: esto es una cadena
se encuentra: es una cadena
se encuentra: cadena
no se encuentra

[editar] Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

[editar] Véase también