CKTIS / C++
std::basic_string::npos — nič sa nenašlo alebo až do konca
Skôr než výsledok `find` použiješ ako index, porovnaj ho s `npos`. V parametri dĺžky funkcie `substr` tá istá konštanta označuje zvyšok reťazca.
Verzia: ISO C++23; implementation support may vary
Syntax
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) prevedie -1 na najväčšiu hodnotu typu bez znamienka size_type danej špecializácie. Nie je to záporné číslo ani aktuálna dĺžka size(). Pre std::string píš std::string::npos.
find vráti index prvého výskytu počítaný od nuly alebo npos, ak nič nenájde. Výsledok ulož pomocou auto alebo size_type, nie do int, a porovnaj ho s npos pred použitím ako indexu či výpočtom pos + 1. Ak chýba povinný oddeľovač, záznam odmietni. Pri rfind naopak predvolené pos = npos neurčuje hornú hranicu pozície výskytu; návratová hodnota npos stále znamená, že sa nič nenašlo.
V substr(pos, count) znamená predvolené count = npos „od pos až do konca“. Príliš veľký počet sa obmedzí na size() - pos, no pos > size() vyvolá výnimku std::out_of_range; pri pos == size() vznikne prázdny reťazec. V C++23 obe preťaženia substr, const & aj &&, vracajú reťazec, ktorý vlastní svoje dáta, nie pohľad.
„Až do konca“ platí aj pre append(src, pos, n) a assign(src, pos, n), ak je zdrojom basic_string. Naopak, append(ptr, n) a assign(ptr, n) vyžadujú skutočný počet prvkov dostupných cez ukazovateľ. Neposielaj npos ako dĺžku vyrovnávacej pamäte. Ak hodnoty z data() a size() posielaš rozhraniu, ktoré prijíma ukazovateľ a dĺžku, over jeho požiadavky na rozsah a životnosť dát.
Prí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ýsledok
mode: fast missing '='
Prvý záznam sa rozdelí na kľúč `mode` a hodnotu `fast`, ktoré sa vypíšu s dvojbodkou medzi nimi. V druhom zázname chýba `=`, takže program ohlási chybu pred výpočtom počiatočnej pozície hodnoty.
Súvisiace lekcie
- C++ · Lekcia 58 · Pokročilá · Verzia: 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