CKTIS / C++
std::string::find — prvo podudaranje i npos
Pronađi indeks znaka ili podniza i usporedi ga s `std::string::npos` prije nego što ga upotrijebiš kao indeks ili kopiraš odnosno izmijeniš tekst.
Verzija: ISO C++23; implementation support may vary
Sintaksa
// C++23 member declarations, with types written for std::string (<string>).
// The template participates only if const T& is implicitly convertible to
// std::string_view but not to const char*.
constexpr size_type find(char ch, size_type pos = 0) const noexcept;
constexpr size_type find(const std::string& needle, size_type pos = 0) const noexcept;
constexpr size_type find(const char* needle, size_type pos = 0) const;
constexpr size_type find(const char* needle, size_type pos, size_type count) const;
template<class T>
constexpr size_type find(const T& needle, size_type pos = 0) const
noexcept(std::is_nothrow_convertible_v<const T&, std::string_view>);
static constexpr size_type npos = size_type(-1);std::string::find je članska funkcija const klase std::string iz zaglavlja <string>. Vraća najmanji indeks podudaranja, brojen od nule, koji je jednak pos ili veći (zadano 0). Cijeli uzorak mora stati u tekst. Prazan se uzorak podudara na položaju pos ako vrijedi pos <= s.size(); neprazan se uzorak ne može podudarati ako vrijedi pos >= s.size(). Pretraga razlikuje velika i mala slova. Indeksi broje elemente char, a ne kodne točke Unicodea.
Rezultat je tipa std::string::size_type. Kad nema podudaranja, funkcija ne baca iznimku: vraća std::string::npos, najveću vrijednost tog nepredznačenog tipa. Provjeri i != std::string::npos prije indeksiranja ili računanja s indeksom. if (i) daje neistinu za valjano podudaranje na indeksu 0, a istinu za npos. Rezultat je broj, ne iterator ni pogled, i nakon promjene teksta možda više ne označava isto podudaranje.
Za jedan znak upotrijebi s.find('!'). Za podniz proslijedi std::string, std::string_view ili valjan niz završen nul-znakom, kao u s.find("ab"). U s.find(ptr, pos, count) parametar count označava duljinu uzorka, a ne granicu pretrage; uzorak može sadržavati \0. Proslijeđeni pokazivač ili pogled mora upućivati na valjane podatke tijekom cijelog poziva. Nevaljan raspon ne daje npos, nego uzrokuje nedefinirano ponašanje.
Preopterećenja za char i std::string jesu noexcept; preopterećenja koja primaju pokazivač nisu deklarirana kao noexcept. Predloško preopterećenje, dostupno od C++17, prihvaća tipove implicitno pretvorive u std::string_view, ali ne u const char*; njegov noexcept ovisi o pretvorbi u pogled. Sva su preopterećenja constexpr od C++20. Ako trebaš samo odgovor da/ne bez početnog položaja, s.contains('!') alternativa je iz C++23 ako je biblioteka podržava.
Ako je s već objekt tipa std::string, provjeri s.find('!') != std::string::npos prije izrade radne kopije ili izmjene teksta. Sama pretraga ne kopira niti mijenja s. Ova provjera odbija !, ali ne zamjenjuje ostala pravila provjere ulaza.
Primjeri
#include <iostream>
#include <string>
void process(const std::string& input) {
const auto bad = input.find('!');
if (bad != std::string::npos) {
std::cout << "rejected at " << bad << '\n';
return;
}
auto result = input;
result += '.';
std::cout << "accepted: " << result << '\n';
}
int main() {
const std::string invalid = "!abc";
const std::string valid = "abc";
process(invalid);
process(valid);
}Rezultat
rejected at 0 accepted: abc.
U `!abc` znak `!` nalazi se na indeksu `0`, pa funkcija završava prije izrade kopije. U `abc` nema podudaranja i tek tada funkcija izrađuje kopiju i dodaje joj točku.
Povezane lekcije
- C++ · Lekcija 15 · Napredno · Verzija: 3