std::basic_string<CharT,Traits,Allocator>::find_first_not_of
Материал из cppreference.com
< cpp | string | basic string
(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 |
(начиная с C++17) (до C++20) |
|
template< class StringViewLike > constexpr size_type |
(начиная с 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.
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 |
восстановлены |
[править] Смотрите также
находит первое вхождение заданной подстроки (public функция-элемент) | |
ищет последнее вхождение подстроки (public функция-элемент) | |
ищет первое вхождение символов (public функция-элемент) | |
ищет последнее вхождение символов (public функция-элемент) | |
ищет последнее отсутствие символов (public функция-элемент) | |
(C++17) |
ищет первое отсутствие символов (public функция-элемент std::basic_string_view<CharT,Traits> )
|