Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::basic_string::find — hledání podřetězců a povinných oddělovačů

Najděte první shodu od zadané pozice, zkontrolujte `npos` a zadejte délku vzoru výslovně, pokud může vyrovnávací paměť obsahovat nulové znaky.

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

Syntaxe

// 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á funkce const z hlavičky <string>, dostupná i pro std::string. Vrací index typu size_type počítaný od nuly: první pozici od pos (výchozí hodnota 0), na níž se celý vzor vejde a shoduje. Prvky porovnává pomocí Traits::eq. U UTF-8 uloženého v std::string index počítá bajty, nikoli znaky viditelné pro uživatele.

Pokud shoda neexistuje, funkce vrátí npos, největší hodnotu typu size_type, a nevyvolá výjimku. Prázdný vzor se shoduje na pos právě tehdy, když pos <= size(); neprázdný vzor se nemůže shodovat, když pos >= size(). U povinného oddělovače zkontrolujte npos před indexováním, vyjmutím podřetězce nebo výpočtem posunu. Index 0 je platný výsledek.

find(ch, pos) hledá jeden prvek CharT; find(str, pos) použije celou délku objektu basic_string. find(p, pos) vyžaduje posloupnost ukončenou nulovým znakem: Traits::length se zastaví na prvním nulovém znaku. find(p, pos, count) použije přesně count prvků vzoru včetně nul uvnitř. Druhý argument je počáteční pozice, nikoli délka; count neomezuje prohledávaný řetězec. Neplatný rozsah určený ukazatelem vede k nedefinovanému chování. Ověřte, že count nepřekračuje počet čitelných prvků od p.

Od C++17 přijímá šablonové přetížení const T&, pokud je implicitně převoditelné na std::basic_string_view<CharT, Traits>, ale ne na const CharT*. Pohled uchovává svou délku, ale data nevlastní. Data odkazovaná pohledem nebo ukazatelem musí zůstat platná po celou dobu volání. U bufferu std::vector<char> používejte data() společně se size(); nepředpokládejte ukončovací nulový znak.

Všechna přetížení jsou od C++20 constexpr. V C++23 jsou přetížení pro basic_string a CharT označena noexcept, ukazatelová přetížení nejsou deklarována jako noexcept a šablonové přetížení je noexcept jen tehdy, když převod na pohled nemůže vyvolat výjimku. Podpora se může lišit podle implementace.

Pří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ýsledek

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

Volání jen s ukazatelem hledá `:` a vrátí `1`. Volání s délkou najde celý povinný oddělovač `:\0=` na indexu `3`. Hledání stejného vzoru pomocí pohledu od indexu `4` vrátí `npos`.

Související lekce

  • C++ · Lekce 58 · Pokročilá · Verze: 3

Zdroje