CKTIS / C++
std::basic_string::npos — nic nenalezeno nebo až do konce
Než výsledek `find` použiješ jako index, porovnej ho s `npos`. V parametru délky funkce `substr` tatáž konstanta označuje zbytek řetězce.
Verze: ISO C++23; implementation support may vary
Syntaxe
static constexpr size_type npos = size_type(-1); // member of std::basic_string in <string>
std::basic_string<CharT, Traits, Allocator>::npos
std::string::npos // for std::basic_string<char>std::basic_string::npos je statický člen constexpr deklarovaný v <string>. Inicializátor size_type(-1) převede -1 na největší hodnotu bezznaménkového typu size_type dané specializace. Není to záporné číslo ani aktuální délka size(). Pro std::string piš std::string::npos.
find vrací index prvního výskytu počítaný od nuly, nebo npos, pokud nic nenajde. Výsledek ulož pomocí auto nebo size_type, nikoli do int, a porovnej ho s npos před použitím jako indexu či výpočtem pos + 1. Pokud chybí povinný oddělovač, záznam odmítni. Naproti tomu výchozí pos = npos u rfind neurčuje horní mez pozice výskytu; návratová hodnota npos stále znamená, že se nic nenašlo.
V substr(pos, count) znamená výchozí count = npos „od pos až do konce“. Příliš velký počet se omezí na size() - pos, ale pos > size() vyvolá výjimku std::out_of_range; při pos == size() vznikne prázdný řetězec. V C++23 obě přetížení substr, const & i &&, vracejí řetězec, který vlastní svá data, nikoli pohled.
„Až do konce“ platí i pro append(src, pos, n) a assign(src, pos, n), pokud je zdrojem basic_string. Naproti tomu append(ptr, n) a assign(ptr, n) vyžadují skutečný počet prvků dostupných přes ukazatel. Nepředávej npos jako délku bufferu. Pokud hodnoty z data() a size() předáváš rozhraní, které přijímá ukazatel a délku, ověř jeho požadavky na rozsah a dobu života dat.
Příklady
#include <iostream>
#include <string>
int main() {
const std::string records[] = {"mode=fast", "mode"};
for (const auto& record : records) {
const auto sep = record.find('=');
if (sep == std::string::npos) {
std::cout << "missing '='\n";
continue;
}
const auto key = record.substr(0, sep);
const auto value = record.substr(sep + 1, std::string::npos);
std::cout << key << ": " << value << '\n';
}
}
Výsledek
mode: fast missing '='
První záznam se rozdělí na klíč `mode` a hodnotu `fast`, které se vypíšou s dvojtečkou mezi nimi. Ve druhém záznamu chybí `=`, takže program ohlásí chybu před výpočtem počáteční pozice hodnoty.
Související lekce
- C++ · Lekce 58 · Pokročilá · Verze: 3
Zdroje
- N4950 — Working Draft, Programming Languages — C++ (C++23)
- [basic.string] Class template basic_string
- [conv.integral] Integral conversions
- [string.find] basic_string searching
- [string.view.find] basic_string_view searching
- [string.substr] basic_string::substr
- [string.cons] basic_string constructors and assignment operators
- [string.append] basic_string::append
- [string.assign] basic_string::assign