CKTIS / C++
std::basic_string::find — zoeken naar deelstrings en verplichte scheidingstekens
Zoek de eerste overeenkomst vanaf een startpositie, controleer op `npos` en geef de patroonlengte expliciet op als een buffer nultekens kan bevatten.
Versie: ISO C++23; implementation support may vary
Syntax
// 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 is een const-lidfunctie uit <string> die ook beschikbaar is op std::string. De functie geeft een vanaf nul getelde index van het type size_type terug: de eerste positie vanaf pos (standaard 0) waar het hele patroon past en overeenkomt. De elementen worden vergeleken met Traits::eq. Bij UTF-8 in std::string telt de index bytes, geen voor de gebruiker zichtbare tekens.
Zonder overeenkomst geeft de functie npos terug, de grootste waarde van size_type; dit werpt geen uitzondering op. Een leeg patroon komt overeen op pos precies wanneer pos <= size(); een niet-leeg patroon kan niet overeenkomen wanneer pos >= size(). Controleer bij een verplicht scheidingsteken op npos voordat je indexeert, een deelstring neemt of een offset berekent. Index 0 is een geldig resultaat.
find(ch, pos) zoekt één CharT-element; find(str, pos) gebruikt de volledige lengte van een basic_string. find(p, pos) vereist een door een nulteken afgesloten reeks: Traits::length stopt bij het eerste nulteken. find(p, pos, count) gebruikt precies count patroonelementen, inclusief ingebedde nultekens. Het tweede argument is de startpositie, geen lengte; count begrenst de doorzochte string niet. Een ongeldig pointerbereik leidt tot ongedefinieerd gedrag. Controleer dus dat count niet groter is dan het aantal leesbare elementen vanaf p.
Sinds C++17 accepteert de template-overload const T& als dat impliciet converteerbaar is naar std::basic_string_view<CharT, Traits>, maar niet naar const CharT*. Een view bewaart zijn lengte, maar is geen eigenaar van de gegevens. Houd de gegevens achter een view of pointer geldig tijdens de hele aanroep. Gebruik bij een std::vector<char>-buffer data() samen met size(); ga niet uit van een afsluitend nulteken.
Alle overloads zijn constexpr sinds C++20. In C++23 zijn de overloads voor basic_string en CharT noexcept, zijn de pointeroverloads niet als noexcept gedeclareerd en is de template-overload alleen noexcept als de conversie naar de view geen uitzondering kan werpen. Ondersteuning kan per implementatie verschillen.
Voorbeelden
#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';
}
}Resultaat
C string: 1 Counted separator: 3 From index 4: not found
De aanroep met alleen de pointer zoekt `:` en geeft `1` terug. De aanroep met een lengte vindt het volledige verplichte scheidingsteken `:\0=` op index `3`. Zoeken naar hetzelfde patroon als view vanaf index `4` geeft `npos` terug.
Gerelateerde lessen
- C++ · Les 58 · Gevorderd · Versie: 3
Bronnen
- 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++