std::basic_string::find - cppreference.com

</tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody>

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.

1) Encuentra la primera subcadena igual a str.

2) Encuentra la primera subcadena igual al rango [s, s+count). Este rango puede contener caracteres nulos.

3) Encuentra la primera subcadena igual a la cadena de caracteres a la que apunta s. La longitud de la cadena se determina por el primer carácter nulo usando Traits::length(s).

4) Encuentra el primer carácter ch (se trata como una subcadena de un solo carácter debido a las reglas formales explicadas más abajo).

5) Implícitamente convierte t a una vista sobre cadena sv como si fuera mediante std::basic_string_view<CharT, Traits> sv = t;, entonces encuentra la primera subcadena igual a sv. Esta sobrecarga solo participa en la resolución de sobrecargas si std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> es true y std::is_convertible_v<const T&, const CharT*> es false.

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.

Parámetros

Valor de retorno

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

Excepciones

2-3) No lanza nada.

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

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.

Véase también