CKTIS / C++
std::string::find — първо съвпадение и npos
Намери индекса на знак или подниз и го сравни със `std::string::npos`, преди да го използваш като индекс или да копираш или променяш текста.
Версия: ISO C++23; implementation support may vary
Синтаксис
// C++23 member declarations, with types written for std::string (<string>).
// The template participates only if const T& is implicitly convertible to
// std::string_view but not to const char*.
constexpr size_type find(char ch, size_type pos = 0) const noexcept;
constexpr size_type find(const std::string& needle, size_type pos = 0) const noexcept;
constexpr size_type find(const char* needle, size_type pos = 0) const;
constexpr size_type find(const char* needle, size_type pos, size_type count) const;
template<class T>
constexpr size_type find(const T& needle, size_type pos = 0) const
noexcept(std::is_nothrow_convertible_v<const T&, std::string_view>);
static constexpr size_type npos = size_type(-1);std::string::find е член-функция const на std::string от заглавния файл <string>. Тя връща най-малкия индекс на съвпадение, броен от нула, който е равен на pos (по подразбиране 0) или е по-голям. Целият търсен образец трябва да се побере в текста. Празен образец съвпада на позиция pos, ако pos <= s.size(); непразен образец не може да съвпадне, ако pos >= s.size(). Търсенето различава главни и малки букви. Индексите броят елементи char, а не кодови точки на Unicode.
Резултатът е от тип std::string::size_type. Липсата на съвпадение не предизвиква изключение: функцията връща std::string::npos, най-голямата стойност на този беззнаков тип. Провери i != std::string::npos, преди да индексираш или да пресмяташ с индекса. if (i) е невярно при валидно съвпадение на индекс 0 и вярно при npos. Резултатът е число, а не итератор или изглед, и след промяна на текста може вече да не обозначава същото съвпадение.
За един знак използвай s.find('!'). За подниз подай std::string, std::string_view или валиден низ, завършващ с нулев знак, както в s.find("ab"). В s.find(ptr, pos, count) параметърът count е дължината на образеца, а не граница на търсенето; образецът може да включва \0. Подаденият указател или изглед трябва да сочи към валидни данни през цялото извикване. Невалиден диапазон не дава npos, а води до неопределено поведение.
Претоварванията за char и std::string са noexcept; тези с указател не са декларирани като noexcept. Шаблонното претоварване, налично от C++17, приема типове, които се преобразуват неявно в std::string_view, но не и в const char*; неговият noexcept зависи от преобразуването към изглед. От C++20 всички претоварвания са constexpr. Ако е нужен само отговор „да“ или „не“ и не е нужна начална позиция, s.contains('!') е алтернатива от C++23, ако библиотеката я поддържа.
Ако s вече е обект от тип std::string, провери s.find('!') != std::string::npos, преди да създадеш работно копие или да промениш текста. Самото търсене не копира и не променя s. Тази проверка отхвърля !, но не отменя останалите правила за проверка на входа.
Примери
#include <iostream>
#include <string>
void process(const std::string& input) {
const auto bad = input.find('!');
if (bad != std::string::npos) {
std::cout << "rejected at " << bad << '\n';
return;
}
auto result = input;
result += '.';
std::cout << "accepted: " << result << '\n';
}
int main() {
const std::string invalid = "!abc";
const std::string valid = "abc";
process(invalid);
process(valid);
}Резултат
rejected at 0 accepted: abc.
В `!abc` знакът `!` е на индекс `0`, затова функцията приключва, преди да създаде копие. В `abc` няма съвпадение и едва тогава функцията създава копие и добавя точка към него.
Свързани уроци
- C++ · Урок 15 · Напреднало · Версия: 3