Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::basic_string::find — iskanje podnizov in obveznih ločil

Poišči prvo ujemanje od podanega položaja, preveri `npos` in izrecno podaj dolžino vzorca, če lahko medpomnilnik vsebuje ničelne znake.

Različica: 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 glave <string>, ki je na voljo tudi pri std::string. Vrne indeks tipa size_type, štet od nič: prvi položaj od pos naprej (privzeto 0), na katerem se prilega in ujema celoten vzorec. Elemente primerja z Traits::eq. Pri UTF-8 v std::string indeks šteje bajte, ne znakov, ki jih vidi uporabnik.

Če ni ujemanja, funkcija vrne npos, največjo vrednost tipa size_type, in ne sproži izjeme. Prazen vzorec se ujema na pos natanko takrat, ko velja pos <= size(); neprazen vzorec se ne more ujemati, če velja pos >= size(). Pri obveznem ločilu preveri npos pred indeksiranjem, izrezovanjem podniza ali računanjem odmika. Indeks 0 je veljaven rezultat.

find(ch, pos) išče en element CharT; find(str, pos) uporabi celotno dolžino objekta basic_string. find(p, pos) zahteva zaporedje, zaključeno z ničelnim znakom: Traits::length se ustavi pri prvem ničelnem znaku. find(p, pos, count) uporabi natanko count elementov vzorca, tudi notranje ničelne znake. Drugi argument je začetni položaj, ne dolžina; count ne omeji preiskovanega niza. Neveljaven obseg, podan s kazalcem, povzroči nedefinirano vedenje. Preveri, da count ne presega števila berljivih elementov od p naprej.

Od C++17 preobremenitev s predlogo sprejme const T&, če ga je mogoče implicitno pretvoriti v std::basic_string_view<CharT, Traits>, ne pa v const CharT*. Pogled ohrani svojo dolžino, vendar ni lastnik podatkov. Podatki, na katere se sklicuje pogled ali kazalec, morajo ostati veljavni ves čas klica. Za medpomnilnik std::vector<char> uporabi data() skupaj s size(); ne predpostavljaj končnega ničelnega znaka.

Vse preobremenitve so od C++20 constexpr. V C++23 sta različici za basic_string in CharT noexcept, različici s kazalcem nista deklarirani kot noexcept, različica s predlogo pa je noexcept le, če pretvorba v pogled ne more sprožiti izjeme. Podpora se lahko razlikuje med implementacijami.

Primeri

#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

Klic samo s kazalcem išče `:` in vrne `1`. Klic z dolžino najde celotno obvezno ločilo `:\0=` na indeksu `3`. Iskanje istega vzorca s pogledom od indeksa `4` vrne `npos`.

Povezane lekcije

  • C++ · Lekcija 58 · Napredna · Različica: 3

Viri