Namespaces
Variants

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

From cppreference.net
std::basic_string
size_type find_first_of ( const basic_string & str, size_type pos = 0 ) const ;
(1) (noexcept начиная с C++11)
(constexpr начиная с C++20)
size_type find_first_of ( const CharT * s,
size_type pos, size_type count ) const ;
(2) (constexpr начиная с C++20)
size_type find_first_of ( const CharT * s, size_type pos = 0 ) const ;
(3) (constexpr начиная с C++20)
size_type find_first_of ( CharT ch, size_type pos = 0 ) const ;
(4) (noexcept начиная с C++11)
(constexpr начиная с C++20)
template < class StringViewLike >

size_type
find_first_of ( const StringViewLike & t,

size_type pos = 0 ) const noexcept ( /* см. ниже */ ) ;
(5) (начиная с C++17)
(constexpr начиная с 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) Ничего не выбрасывает.
5)
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);
    // совпадений нет
    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++.

DR Applied to Behavior as published Correct behavior
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
восстановлены

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

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