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

Findet das erste Zeichen, das einem der Zeichen in der gegebenen Zeichensequenz entspricht. Die Suche berücksichtigt nur den Bereich [pos, size()). Wenn keines der Zeichen in der gegebenen Zeichensequenz im Bereich vorhanden ist, wird npos zurückgegeben.

Parameter

Rückgabewert

Position des gefundenen Zeichens oder npos falls kein solches Zeichen gefunden wurde.

Exceptions

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).

Hinweise

Traits :: eq ( ) wird verwendet, um den Vergleich durchzuführen.

Beispiel

#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);
    // keine Übereinstimmung
    assert(sz == std::string::npos);
    // (2)
    sz = "consteval"s.find_first_of("xyzabc", 0, 3);
    // keine Übereinstimmung (× sind keine Ziele)     ×××
    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.

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch