std::basic_string<CharT,Traits,Allocator>:: find_first_of
|
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
|
(5) |
(начиная с C++17)
(constexpr начиная с C++20) |
Находит первый символ, равный одному из символов в заданной последовательности символов. Поиск рассматривает только диапазон
[
pos
,
size()
)
. Если ни один из символов в заданной последовательности символов не присутствует в диапазоне,
npos
будет возвращено.
[
s
,
s
+
count
)
. Этот диапазон может включать нулевые символы.
[
s
,
s
+
Traits
::
length
(
s
)
)
не является
допустимым диапазоном
, поведение не определено.
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 если такой символ не найден.
Исключения
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Примечания
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>
)
|
|
|
возвращает длину максимального начального сегмента, который состоит
только из символов, найденных в другой байтовой строке (функция) |