std::basic_string<CharT,Traits,Allocator>::find_first_of
Материал из cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| (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(/* смотрите ниже */); |
(начиная с C++17) (до C++20) |
|
template< class StringViewLike > constexpr size_type find_first_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* смотрите ниже */); |
(начиная с C++20) | |
Находит первый символ, равный одному из символов в заданной последовательности символов. При поиске учитывается только диапазон [pos, size()). Если ни один из символов в данной последовательности символов не присутствует в диапазоне, будет возвращено npos.
1) Находит первый символ, равный одному из символов в
str.2) Находит первый символ, равный одному из символов в диапазоне
[s, s + count). Этот диапазон может включать нулевые символы.3) Находит первый символ, равный одному из символов в строке символов, на которую указывает
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 << "Все тесты пройдены.\n";
}
Вывод:
Все тесты пройдены.
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| LWG 847 | C++98 | не было гарантии безопасности исключений | добавлена надёжная гарантия безопасности исключений |
| LWG 2064 | C++11 | перегрузки (3,4) были noexcept | удалено |
| LWG 2946 | C++17 | перегрузка (5) в некоторых случаях вызывала двусмысленность |
исправлено, сделав её шаблоном |
| WG не указан | C++11 C++17 |
noexcept перегрузок (4,5) были случайно удалены LWG2064/LWG2946 |
восстановлены |
Смотрите также
| находит первое вхождение заданной подстроки (public функция-элемент) | |
| ищет последнее вхождение подстроки (public функция-элемент) | |
| ищет первое отсутствие символов (public функция-элемент) | |
| ищет последнее вхождение символов (public функция-элемент) | |
| ищет последнее отсутствие символов (public функция-элемент) | |
(C++17) |
ищет первое вхождение символов (public функция-элемент std::basic_string_view<CharT,Traits>)
|
| возвращает длину максимального начального сегмента, который состоит только из символов, найденных в другой строке байтов (функция) |