База знанияИзпитен център
BGБългарски
Избери език13

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

Източници