std::basic_string<CharT,Traits,Allocator>::find — cppreference.com
Материал из 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) | ||
|
|
(до C++11) | |
|
|
(начиная с C++11) (до C++20) |
|
|
|
(начиная с C++20) | |
| (2) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (3) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (4) | ||
|
|
(до C++11) | |
|
|
(начиная с C++11) (до C++20) |
|
|
|
(начиная с C++20) | |
| (5) | ||
|
|
(начиная с C++17) (до C++20) |
|
|
|
(начиная с C++20) | |
Находит первую подстроку, равную заданной последовательности символов. Поиск начинается с pos, т.е. найденная подстрока не должна начинаться с позиции, предшествующей pos.
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 считается найденной в позиции xpos, если все следующие условия true:
xpos >= posxpos + str.size() <= size()- для всех позиций
nвstr,Traits::eq(at(xpos + n), str.at(n)).
В частности, это означает, что
- подстроку можно найти, только если
pos <= size() - str.size() - пустая подстрока находится в
posтогда и только тогда, когдаpos <= size() - для непустой подстроки, если
pos >= size(), функция всегда возвращает npos.
Параметры
| 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>>)
Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).
Пример
#include <iomanip> #include <iostream> #include <string> void print(int id, std::string::size_type n, std::string const& s) { std::cout << id << ") "; if (std::string::npos == n) std::cout << "не найдено! n == npos\n"; else std::cout << "найдено @ n = " << n << ", substr(" << n << ") = " << std::quoted(s.substr(n)) << '\n'; } int main() { std::string::size_type n; std::string const s = "This is a string"; /* ^ ^ ^ 1 2 3 */ // поиск с начала строки n = s.find("is"); print(1, n, s); // поиск с позиции 5 n = s.find("is", 5); print(2, n, s); // поиск одного символа n = s.find('a'); print(3, n, s); // поиск одного символа n = s.find('q'); print(4, n, s); }
Вывод:
1) найдено @ n = 2, substr(2) = "is is a string" 2) найдено @ n = 5, substr(5) = "is a string" 3) найдено @ n = 8, substr(8) = "a string" 4) не найдено! n == npos
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам 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>) [править]
|
| ищет диапазон элементов (шаблон функции) [править] |