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