std::basic_string<CharT,Traits,Allocator>::find_first_not_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_not_of( const basic_string& str, size_type pos = 0 ) const; |
(до C++11) | |
size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const noexcept; |
(начиная с C++11) (до C++20) |
|
constexpr size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const noexcept; |
(начиная с C++20) | |
| (2) | ||
size_type find_first_not_of( const CharT* s, size_type pos, size_type count ) const; |
(до C++20) | |
constexpr size_type find_first_not_of( const CharT* s, size_type pos, size_type count ) const; |
(начиная с C++20) | |
| (3) | ||
size_type find_first_not_of( const CharT* s, size_type pos = 0 ) const; |
(до C++20) | |
constexpr size_type find_first_not_of( const CharT* s, size_type pos = 0 ) const; |
(начиная с C++20) | |
| (4) | ||
size_type find_first_not_of( CharT ch, size_type pos = 0 ) const; |
(до C++11) | |
size_type find_first_not_of( CharT ch, size_type pos = 0 ) const noexcept; |
(начиная с C++11) (до C++20) |
|
constexpr size_type find_first_not_of( CharT ch, size_type pos = 0 ) const noexcept; |
(начиная с C++20) | |
| (5) | ||
template< class StringViewLike > size_type find_first_not_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* смотрите ниже */); |
(начиная с C++17) (до C++20) |
|
template< class StringViewLike > constexpr size_type find_first_not_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.
Во всех случаях равенство проверяется вызовом Traits::eq.
Параметры
| str | — | строка, определяющая символы для поиска |
| pos | — | позиция для начала поиска |
| count | — | длина строки символов, определяющей символы для поиска |
| s | — | указатель на строку символов, определяющую символы для поиска |
| ch | — | символ, идентифицирующий символы для поиска |
| t | — | объект (конвертируемый в std::basic_string_view), идентифицирующий символы для поиска |
Возвращаемое значение
Позиция найденного символа или std::string::npos, если такой символ не найден.
Исключения
1,4) Ничего не генерирует.
5)
спецификация noexcept:
noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>)Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).
Пример
Запустить этот код
#include <iostream>
#include <string>
int main()
{
// Разрешить использование прописных и строчных букв и цифр в именах макросов.
const char* pattern = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
"abcdefghijklmnopqrstuvwxyz"
"0123456789";
std::string data = "1) %FIX, 2) %HACK и 3) %TODO";
const std::string replacement = "%DONE%";
std::cout << "Перед: " << data << '\n';
for (std::string::size_type first{}, last{};
(first = data.find('%', first)) != std::string::npos;
first += replacement.size())
{
last = data.find_first_not_of(pattern, first + 1);
if (last == std::string::npos)
last = data.length();
// Теперь first это '%', а last на один символ за концом найденной подстроки
data.replace(first, last - first, replacement);
}
std::cout << "После: " << data << '\n';
}
Вывод:
Перед: 1) %FIX, 2) %HACK и 3) %TODO
После: 1) %DONE%, 2) %DONE% и 3) %DONE%
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам 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 |
восстановлены |