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

	(1)
size_type find_first_of( const basic_string& str, size_type pos = 0 ) const;		(до C++11)
size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept;		(с C++11) (до C++20)
constexpr size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept;		(с C++20)
	(2)
size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;		(до C++20)
constexpr size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;		(с C++20)
	(3)
size_type find_first_of( const CharT* s, size_type pos = 0 ) const;		(до C++20)
constexpr size_type find_first_of( const CharT* s, size_type pos = 0 ) const;		(с C++20)
	(4)
size_type find_first_of( CharT ch, size_type pos = 0 ) const;		(до C++11)
size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept;		(с C++11) (до C++20)
constexpr size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept;		(с C++20)
	(5)
template< class StringViewLike > size_type find_first_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* see below */);		(с C++17) (до C++20)
template< class StringViewLike > constexpr size_type find_first_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* see below */);		(с C++20)

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

1) Находит первый символ, равный одному из символов в str.

2) Находит первый символ, равный одному из символов в диапазоне [s, s + count). Этот диапазон может включать нулевые символы.

Если [s, s + count) не является допустимым диапазоном, поведение неопределено.

3) Находит первый символ, равный одному из символов в строке символов, на которую указывает s. Длина строки определяется первым нулевым символом с использованием Traits::length(s).

Если [s, s + Traits::length(s)) не является допустимым диапазоном, поведение неопределено.

4) Находит первый символ, равный ch.

5) Неявно преобразует t в строковый вид sv как если бы это было сделано с помощью std::basic_string_view<CharT, Traits> sv = t;, а затем находит первый символ, равный одному из символов в sv.

Данная перегрузка участвует в разрешении перегрузки только если

std::is_convertible_v<const StringViewLike&,
 std::basic_string_view<CharT, Traits>>

является true и std::is_convertible_v<const StringViewLike&, const CharT*> является false.

Параметры

str	-	строка, определяющая символы для поиска
pos	-	позиция, с которой начать поиск
count	-	длина строки символов, определяющей символы для поиска
s	-	указатель на строку символов, определяющих символы для поиска
ch	-	символ для поиска
t	-	объект (преобразуемый в `std::basic_string_view`) определяющий символы для поиска

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

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

Исключения

1,4) Ничего не выбрасывает.

noexcept спецификация:

noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)

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

Примечания

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);
    // no match
    assert(sz == std::string::npos);
 
    // (2)
    sz = "consteval"s.find_first_of("xyzabc", 0, 3);
    // no match (× are not targets)     ×××
    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++.

DR	Применён к	Поведение, как опубликовано	Правильное поведение
LWG 847	C++98	гарантии безопасности исключений не было	добавлена гарантия сильной безопасности исключений
LWG 2064	C++11	перегрузки (3,4) были noexcept	удалены
LWG 2946	C++17	перегрузка (5) вызывала неоднозначность в некоторых случаях	избегается путём преобразования в шаблон
P1148R0	C++11 C++17	noexcept для перегрузок (4,5) были случайно удалены LWG2064/LWG2946	восстановлены

См. также

find	находит первое вхождение заданной подстроки (публичный член-функция)
rfind	находит последнее вхождение подстроки (публичный член-функция)
find_first_not_of	находит первый символ, не являющийся из заданных (публичный член-функция)
find_last_of	находит последнее вхождение заданных символов (публичный член-функция)
find_last_not_of	находит последнее отсутствие заданных символов (публичный член-функция)
find_first_of	находит первое вхождение заданных символов (публичный член-функция `std::basic_string_view<CharT,Traits>`)
strspn	возвращает длину максимального начального сегмента, состоящего только из символов, которые найдены в другой строке байт (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/find_first_of