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
- Draft C++ Standard — basic_string searching [string.find]
- Draft C++ Standard — basic_string_view searching [string.view.find]
- Draft C++ Standard — basic_string_view construction and assignment [string.view.cons]
- Draft C++ Standard — Class template basic_string [basic.string]
- Draft C++ Standard — vector data [vector.data]
- WG21 N4950 — Working Draft, Standard for Programming Language C++