Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::string::find — prvý výskyt a npos

Nájdi index znaku alebo podreťazca a porovnaj ho s `std::string::npos` skôr, než ho použiješ ako index alebo než text skopíruješ či zmeníš.

Verzia: ISO C++23; implementation support may vary

Syntax

// 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 je členská funkcia const typu std::string z hlavičky <string>. Vracia najnižší index výskytu počítaný od nuly, ktorý je aspoň pos (predvolená hodnota 0). Hľadaný vzor sa musí celý zmestiť do textu. Prázdny vzor sa zhoduje na pozícii pos, ak pos <= s.size(); neprázdny vzor nemožno nájsť, ak pos >= s.size(). Vyhľadávanie rozlišuje veľké a malé písmená. Indexy počítajú prvky char, nie kódové body Unicode.

Výsledok má typ std::string::size_type. Ak sa vzor nenájde, funkcia nevyvolá výnimku: vráti std::string::npos, najväčšiu hodnotu tohto typu bez znamienka. Over i != std::string::npos, než index použiješ na prístup k prvku alebo na výpočet. if (i) je nepravdivé pre platný výskyt na indexe 0 a pravdivé pre npos. Výsledok je číslo, nie iterátor ani pohľad; po zmene textu už nemusí označovať rovnaký výskyt.

Na vyhľadanie jedného znaku použi s.find('!'). Pre podreťazec odovzdaj std::string, std::string_view alebo platný reťazec ukončený nulovým znakom, ako v s.find("ab"). V s.find(ptr, pos, count) parameter count určuje dĺžku vzoru, nie hranicu vyhľadávania; vzor môže obsahovať \0. Odovzdaný ukazovateľ alebo pohľad musí počas celého volania odkazovať na platné údaje. Neplatný rozsah nevracia npos, ale spôsobuje nedefinované správanie.

Preťaženia pre char a std::string sú noexcept; preťaženia s ukazovateľom nie sú deklarované ako noexcept. Šablónové preťaženie dostupné od C++17 prijíma typy implicitne konvertovateľné na std::string_view, ale nie na const char*; jeho noexcept závisí od konverzie na pohľad. Od C++20 sú všetky preťaženia constexpr. Ak stačí odpoveď áno/nie a netreba zadať počiatočnú pozíciu, s.contains('!') je alternatíva z C++23, pokiaľ ju knižnica podporuje.

Ak je s už objektom typu std::string, over s.find('!') != std::string::npos pred vytvorením pracovnej kópie alebo zmenou textu. Samotné vyhľadávanie s nekopíruje ani nemení. Táto kontrola odmietne !, ale nenahrádza ostatné pravidlá validácie.

Príklady

#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);
}

Výsledok

rejected at 0
accepted: abc.

V `!abc` je `!` na indexe `0`, takže funkcia skončí pred vytvorením kópie. V `abc` sa znak nenájde a až potom funkcia vytvorí kópiu a pridá k nej bodku.

Súvisiace lekcie

  • C++ · Lekcia 15 · Pokročilá · Verzia: 3

Zdroje