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
- 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++