Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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