CKTIS / C++
std::string::find — eerste treffer en npos
Zoek de index van een teken of deelstring en vergelijk die met `std::string::npos` voordat je de index gebruikt of de tekst kopieert of wijzigt.
Versie: ISO C++23; implementation support may vary
Syntax
// 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 is een const-lidfunctie van std::string uit <string>. Ze geeft de laagste, vanaf nul getelde index waarop het zoekpatroon begint, op of na pos (standaard 0). Het hele patroon moet in de tekst passen. Een leeg patroon komt overeen op pos als pos <= s.size(); een niet-leeg patroon kan niet overeenkomen als pos >= s.size(). De zoekactie is hoofdlettergevoelig. Indices tellen char-elementen, geen Unicode-codepunten.
Het resultaat heeft het type std::string::size_type. Als er geen treffer is, volgt er geen uitzondering: de functie geeft std::string::npos, de grootste waarde van dat type zonder teken. Controleer i != std::string::npos voordat je indexeert of met de index rekent. if (i) is onwaar voor een geldige treffer op 0 en waar voor npos. Het resultaat is een getal, geen iterator of view, en kan na een wijziging van de tekst niet meer dezelfde treffer aanduiden.
Gebruik s.find('!') voor één teken. Geef voor een deelstring een std::string, een std::string_view of een geldige, met een nulteken afgesloten tekenreeks mee, zoals in s.find("ab"). In s.find(ptr, pos, count) is count de lengte van het patroon, geen grens voor het zoeken; het patroon mag \0 bevatten. Een meegegeven pointer of view moet gedurende de hele aanroep naar geldige gegevens verwijzen. Een ongeldig bereik geeft geen npos, maar veroorzaakt ongedefinieerd gedrag.
De overloads voor char en std::string zijn noexcept; de pointeroverloads zijn niet als noexcept gedeclareerd. De template-overload bestaat sinds C++17 en accepteert typen die impliciet converteerbaar zijn naar std::string_view maar niet naar const char*; zijn noexcept hangt af van de conversie naar de view. Sinds C++20 zijn alle overloads constexpr. Als je alleen ja of nee nodig hebt en geen startpositie wilt opgeven, is s.contains('!') een C++23-alternatief als de bibliotheek het ondersteunt.
Als s al een std::string is, test dan s.find('!') != std::string::npos voordat je een werkkopie maakt of de tekst wijzigt. De zoekactie zelf kopieert of wijzigt s niet. Deze controle wijst ! af, maar vervangt geen andere validatieregels.
Voorbeelden
#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);
}Resultaat
rejected at 0 accepted: abc.
In `!abc` staat `!` op index `0`, dus stopt de functie voordat ze een kopie maakt. In `abc` is er geen treffer; pas dan maakt de functie een kopie en voegt ze een punt toe.
Gerelateerde lessen
- C++ · Les 15 · Gevorderd · Versie: 3