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

CKTIS / C++

std::basic_string::find — vyhľadávanie podreťazcov a povinných oddeľovačov

Nájdite prvú zhodu od zadanej pozície, skontrolujte `npos` a zadajte dĺžku vzoru explicitne, ak môže vyrovnávacia pamäť obsahovať nulové znaky.

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

Syntax

// ISO C++23; member declarations of std::basic_string<CharT, Traits, Allocator> in <string>
constexpr size_type find(const basic_string& str, size_type pos = 0) const noexcept;
constexpr size_type find(const CharT* s, size_type pos, size_type count) const;
constexpr size_type find(const CharT* s, size_type pos = 0) const;
constexpr size_type find(CharT ch, size_type pos = 0) const noexcept;
template<class T>
constexpr size_type find(const T& t, size_type pos = 0) const
    noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>);
// The template participates only if const T& is implicitly convertible to
// std::basic_string_view<CharT, Traits> but not to const CharT*.

std::basic_string::find je členská funkcia const z hlavičky <string>, dostupná aj pre std::string. Vracia index typu size_type počítaný od nuly: prvú pozíciu od pos (predvolená hodnota 0), na ktorej sa celý vzor zmestí a zhoduje. Prvky porovnáva pomocou Traits::eq. Pri UTF-8 uloženom v std::string index počíta bajty, nie znaky viditeľné pre používateľa.

Ak zhoda neexistuje, funkcia vráti npos, najväčšiu hodnotu typu size_type, a nevyvolá výnimku. Prázdny vzor sa zhoduje na pos práve vtedy, keď pos <= size(); neprázdny vzor sa nemôže zhodovať, keď pos >= size(). Pri povinnom oddeľovači skontrolujte npos pred indexovaním, vybratím podreťazca alebo výpočtom posunu. Index 0 je platný výsledok.

find(ch, pos) hľadá jeden prvok CharT; find(str, pos) použije celú dĺžku objektu basic_string. find(p, pos) vyžaduje postupnosť ukončenú nulovým znakom: Traits::length sa zastaví na prvom nulovom znaku. find(p, pos, count) použije presne count prvkov vzoru vrátane núl vo vnútri. Druhý argument je počiatočná pozícia, nie dĺžka; count neobmedzuje prehľadávaný reťazec. Neplatný rozsah určený ukazovateľom vedie k nedefinovanému správaniu. Overte, či count neprekračuje počet čitateľných prvkov od p.

Od C++17 šablónové preťaženie prijíma const T&, ak je implicitne konvertovateľné na std::basic_string_view<CharT, Traits>, ale nie na const CharT*. Pohľad uchováva svoju dĺžku, ale údaje nevlastní. Údaje, na ktoré odkazuje pohľad alebo ukazovateľ, musia zostať platné počas celého volania. Pre buffer std::vector<char> používajte data() spolu so size(); nepredpokladajte koncový nulový znak.

Všetky preťaženia sú od C++20 constexpr. V C++23 sú preťaženia pre basic_string a CharT označené noexcept, ukazovateľové preťaženia nie sú deklarované ako noexcept a šablónové preťaženie je noexcept len vtedy, keď konverzia na pohľad nemôže vyvolať výnimku. Podpora sa môže líšiť podľa implementácie.

Príklady

#include <iostream>
#include <string>
#include <string_view>
#include <vector>

int main() {
    const std::string record{"A:B:\0=C", 7};
    const std::vector<char> separator{':', '\0', '='};

    std::cout << "C string: " << record.find(separator.data()) << '\n';

    const auto split = record.find(separator.data(), 0, separator.size());
    if (split == std::string::npos) {
        std::cout << "Missing required separator\n";
        return 1;
    }
    std::cout << "Counted separator: " << split << '\n';

    const std::string_view marker{separator.data(), separator.size()};
    const auto start = split + 1;
    const auto next = record.find(marker, start);
    std::cout << "From index " << start << ": ";
    if (next == std::string::npos) {
        std::cout << "not found\n";
    } else {
        std::cout << next << '\n';
    }
}

Výsledok

C string: 1
Counted separator: 3
From index 4: not found

Volanie iba s ukazovateľom hľadá `:` a vráti `1`. Volanie s dĺžkou nájde celý povinný oddeľovač `:\0=` na indexe `3`. Hľadanie rovnakého vzoru pomocou pohľadu od indexu `4` vráti `npos`.

Súvisiace lekcie

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

Zdroje