CKTIS / C++
std::string::find — prva pojavitev in npos
Poišči indeks znaka ali podniza in ga primerjaj z `std::string::npos`, preden ga uporabiš kot indeks ali preden besedilo kopiraš oziroma spremeniš.
Različica: 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 razreda std::string iz glave <string>. Vrne najmanjši indeks ujemanja, štet od nič, ki je enak pos ali večji (privzeto 0). Celoten vzorec mora biti znotraj besedila. Prazen vzorec se ujema na mestu pos, če velja pos <= s.size(); neprazen vzorec se ne more ujemati, če velja pos >= s.size(). Iskanje razlikuje med velikimi in malimi črkami. Indeksi štejejo elemente char, ne kodnih točk Unicode.
Rezultat je tipa std::string::size_type. Če ni ujemanja, funkcija ne sproži izjeme: vrne std::string::npos, največjo vrednost tega nepredznačenega tipa. Preveri i != std::string::npos, preden uporabiš indeks za dostop do elementa ali računanje. if (i) je neresničen za veljavno ujemanje na 0 in resničen za npos. Rezultat je število, ne iterator ali pogled; po spremembi besedila morda ne označuje več istega ujemanja.
Za en znak uporabi s.find('!'). Za podniz podaj std::string, std::string_view ali veljaven niz, zaključen z ničelnim znakom, kot v s.find("ab"). Pri s.find(ptr, pos, count) je count dolžina vzorca, ne meja iskanja; vzorec lahko vsebuje \0. Vsak podani kazalec ali pogled se mora ves čas klica nanašati na veljavne podatke. Neveljaven obseg ne vrne npos, temveč povzroči nedefinirano obnašanje.
Preobremenitvi za char in std::string sta noexcept; preobremenitvi s kazalcem nista deklarirani kot noexcept. Predlogovna preobremenitev, na voljo od C++17, sprejema tipe, ki jih je mogoče implicitno pretvoriti v std::string_view, ne pa v const char*; njen noexcept je odvisen od pretvorbe v pogled. Od C++20 so vse preobremenitve constexpr. Če potrebuješ le odgovor da/ne in ne potrebuješ začetnega položaja, je s.contains('!') možnost iz C++23, če jo knjižnica podpira.
Če je s že objekt tipa std::string, preveri s.find('!') != std::string::npos, preden ustvariš delovno kopijo ali spremeniš besedilo. Iskanje samo ne kopira niti ne spreminja s. Ta preizkus zavrne !, ne nadomesti pa drugih pravil preverjanja vhodnih podatkov.
Primeri
#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.
V `!abc` je `!` na indeksu `0`, zato se funkcija konča, še preden ustvari kopijo. V `abc` ni ujemanja; šele nato funkcija ustvari kopijo in ji doda piko.
Povezane lekcije
- C++ · Lekcija 15 · Napredna · Različica: 3