Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::basic_string::find — pretraživanje podnizova i obveznih razdjelnika

Pronađi prvo podudaranje od zadanog položaja, provjeri `npos` i izričito zadaj duljinu uzorka ako međuspremnik može sadržavati nul-znakove.

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

Sintaksa

// 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 članska funkcija const iz zaglavlja <string>, dostupna i za std::string. Vraća indeks tipa size_type koji se broji od nule: prvi položaj od pos nadalje (zadano 0) na kojem cijeli uzorak stane i podudara se. Elemente uspoređuje s pomoću Traits::eq. Za UTF-8 pohranjen u std::string indeks broji bajtove, a ne znakove vidljive korisniku.

Ako nema podudaranja, funkcija vraća npos, najveću vrijednost tipa size_type, i ne baca iznimku. Prazan uzorak podudara se na pos ako i samo ako vrijedi pos <= size(); neprazan se ne može podudarati ako vrijedi pos >= size(). Za obvezni razdjelnik provjeri npos prije indeksiranja, izdvajanja podniza ili računanja pomaka. Indeks 0 valjan je rezultat.

find(ch, pos) traži jedan element CharT; find(str, pos) koristi punu duljinu objekta basic_string. find(p, pos) zahtijeva slijed završen nul-znakom: Traits::length staje na prvom nul-znaku. find(p, pos, count) koristi točno count elemenata uzorka, uključujući nul-znakove unutar njega. Drugi je argument početni položaj, a ne duljina; count ne ograničava niz koji se pretražuje. Nevaljan raspon zadan pokazivačem uzrokuje nedefinirano ponašanje. Provjeri da count ne prelazi broj čitljivih elemenata počevši od p.

Od C++17 preopterećenje s predloškom prihvaća const T& ako se može implicitno pretvoriti u std::basic_string_view<CharT, Traits>, ali ne i u const CharT*. Pogled zadržava svoju duljinu, ali nije vlasnik podataka. Podaci na koje upućuje pogled ili pokazivač moraju ostati valjani tijekom cijelog poziva. Za međuspremnik std::vector<char> koristi data() zajedno sa size(); ne pretpostavljaj završni nul-znak.

Sva su preopterećenja constexpr od C++20. U C++23 preopterećenja za basic_string i CharT jesu noexcept, ona s pokazivačem nisu deklarirana kao noexcept, a preopterećenje s predloškom jest noexcept samo ako pretvorba u pogled ne može baciti iznimku. Podrška može ovisiti o implementaciji.

Primjeri

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

Rezultat

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

Poziv samo s pokazivačem traži `:` i vraća `1`. Poziv s duljinom nalazi cijeli obvezni razdjelnik `:\0=` na indeksu `3`. Traženje istog uzorka kao pogleda od indeksa `4` vraća `npos`.

Povezane lekcije

  • C++ · Lekcija 58 · Napredno · Verzija: 3

Izvori