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

Trouve le premier caractère égal à l'un des caractères de la séquence de caractères donnée. La recherche ne considère que la plage [pos, size()). Si aucun des caractères de la séquence de caractères donnée n'est présent dans la plage, npos est retourné.

Paramètres

Valeur de retour

Position du caractère trouvé ou npos si aucun caractère n'est trouvé.

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 ).

Notes

Traits :: eq ( ) est utilisé pour effectuer la comparaison.

Exemple

#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);
    // aucune correspondance
    assert(sz == std::string::npos);
    // (2)
    sz = "consteval"s.find_first_of("xyzabc", 0, 3);
    // aucune correspondance (× ne sont pas cibles)     ×××
    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.

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