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

size_type find_first_of( const basic_string& str, size_type pos = 0 ) const;

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

size_type find_first_of( const CharT* s, size_type pos = 0 ) const;

size_type find_first_of( CharT ch, size_type pos = 0 ) const;

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

Encuentra el primer carácter igual a uno de los caracteres en la secuencia de caracteres dada. La búsqueda considera solo el rango [pos, size()). Si ninguno de los caracteres en la secuencia de caracteres dada está presente en el rango, se retorna npos.

Parámetros

Valor de retorno

Posición del carácter encontrado o npos si no se encuentra dicho carácter.

Excepciones

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

Notas

Traits :: eq ( ) se utiliza para realizar la comparación.

Ejemplo

#include <cassert>
#include <iostream>
#include <string>
#include <string_view>
int main()
{
    using namespace std::literals;
    std::string::size_type sz;
    // (1)
    sz = "alignas"s.find_first_of("klmn"s);
    //     └────────────────────────┘
    assert(sz == 1);
    sz = "alignof"s.find_first_of("wxyz"s);
    // sin coincidencia
    assert(sz == std::string::npos);
    // (2)
    sz = "consteval"s.find_first_of("xyzabc", 0, 3);
    // sin coincidencia (× no son objetivos)     ×××
    assert(sz == std::string::npos);
    sz = "consteval"s.find_first_of("xyzabc", 0, 6);
    //    └───────────────────────────────┘
    assert(sz == 0);
    // (3)
    sz = "decltype"s.find_first_of("xyzabc");
    //      └────────────────────────────┘
    assert(sz == 2);
    // (4)
    sz = "co_await"s.find_first_of('a');
    //       └──────────────────────┘
    assert(sz == 3);
    // (5)
    sz = "constinit"s.find_first_of("int"sv);
    //      └─────────────────────────┘
    assert(sz == 2);
    std::cout << "All tests passed.\n";
}

All tests passed.

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