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

Находит первый символ, равный одному из символов в заданной последовательности. Поиск рассматривает только диапазон [pos, size()). Если ни один из символов в заданной последовательности не присутствует в диапазоне, будет возвращён npos.

Параметры

Возвращаемое значение

Позиция найденного символа или npos если такой символ не найден.

Исключения

Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).

Примечания

Traits :: eq ( ) используется для выполнения сравнения.

Пример

#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);
    // совпадений нет
    assert(sz == std::string::npos);
    // (2)
    sz = "consteval"s.find_first_of("xyzabc", 0, 3);
    // совпадений нет (× не являются целями)     ×××
    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.

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также