CKTIS / C++
`std::string::npos`: žádná shoda nebo počet znaků až do konce
Výsledek `std::string::find` porovnávejte s `std::string::npos`. Jako počet znaků v `substr` nebo `erase` tatáž konstanta znamená „až do konce“, nikoli počáteční pozici.
Verze: ISO C++23; implementation support may vary
Syntaxe
#include <string>
// Declaration inside std::basic_string in C++23:
// static constexpr size_type npos = size_type(-1);
// For an existing std::string s:
// const auto pos = s.find('#');
// pos == std::string::npos // no match
// pos != std::string::npos // match found
// s.substr(0, std::string::npos) // npos is a count hereV C++23 je std::string::npos člen static constexpr typu std::string::size_type, dostupný přes <string>. Převod -1 na tento typ bez znaménka dává jeho největší reprezentovatelnou hodnotu. Nejde o záporný index; nepředpokládejte konkrétní šířku typu ani desítkovou hodnotu.
input.find('#') vybírá přetížení pro jeden znak. Ve výchozím nastavení hledá od indexu 0 a vrací index prvního výskytu nebo std::string::npos, pokud žádný nenajde. Uložte výsledek pomocí auto nebo std::string::size_type: pos == std::string::npos znamená, že shoda neexistuje, a pos != std::string::npos, že byla nalezena. Nepoužívejte if (pos): platný index 0 dává false, zatímco npos dává true.
Význam závisí na argumentu. s.substr(start, std::string::npos) vrátí samostatný řetězec od start až do konce; s.erase(start, std::string::npos) tuto část z s odstraní. V obou voláních nesmí start překročit s.size(), jinak funkce vyvolá výjimku std::out_of_range. Než výsledek hledání použijete jako index či počáteční pozici nebo s ním budete počítat, ověřte, že byla nalezena shoda.
Příklady
#include <iostream>
#include <string>
void process(const std::string& input)
{
const auto pos = input.find('#');
if (pos != std::string::npos) {
std::cout << "Rejected at index " << pos << '\n';
return;
}
std::string result = input;
result += '!';
std::cout << "Accepted: " << result << '\n';
}
int main()
{
const std::string invalid = "#draft";
const std::string valid = "draft";
process(invalid);
process(valid);
}
Výsledek
Rejected at index 0 Accepted: draft!
V `#draft` je `#` na indexu `0`, takže funkce vstup odmítne ještě před kopírováním jeho obsahu nebo změnou řetězce. V `draft` znak `#` není; funkce zkopíruje vstup a ke kopii připojí `!`, aniž změní původní vstup.
Související lekce
- C++ · Lekce 15 · Pokročilá · Verze: 3
Zdroje
- C++23 working draft N4950 — [basic.string], [string.find], [string.view.find], [string.substr], [string.cons], [string.erase], [conv.integral]
- [basic.string] — Class template basic_string
- [string.find] — basic_string searching
- [string.view.find] — basic_string_view searching
- [string.substr] — basic_string::substr
- [string.erase] — basic_string::erase