KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::basic_string::npos — niet gevonden of tot het einde

Vergelijk het resultaat van `find` met `npos` voordat je het als index gebruikt. Als aantal voor `substr` staat dezelfde constante voor de rest van de tekenreeks.

Versie: 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 is een statisch constexpr-lid dat in <string> is gedeclareerd. De initializer size_type(-1) zet -1 om in de grootste waarde van het unsigned type size_type van de specialisatie. Het is geen negatief getal en ook niet de huidige lengte size(). Voor std::string schrijf je std::string::npos.

find geeft de index van de eerste treffer terug, geteld vanaf nul, of npos als er geen treffer is. Bewaar het resultaat met auto of size_type, niet met int, en vergelijk het met npos voordat je het als index gebruikt of pos + 1 berekent. Ontbreekt een verplicht scheidingsteken, wijs het record dan af. Bij rfind legt de standaardwaarde pos = npos juist geen bovengrens op aan de positie van een treffer; als retourwaarde betekent npos nog steeds ‘geen treffer’.

In substr(pos, count) betekent de standaardwaarde count = npos ‘vanaf pos tot het einde’. Een te groot aantal wordt begrensd tot size() - pos, maar pos > size() veroorzaakt std::out_of_range; pos == size() levert een lege tekenreeks op. In C++23 geven beide overloads van substr, const & en &&, een tekenreeks terug die haar eigen gegevens bezit, geen view.

‘Tot het einde’ geldt ook voor append(src, pos, n) en assign(src, pos, n) met een basic_string als bron. append(ptr, n) en assign(ptr, n) verwachten daarentegen een werkelijk aantal elementen dat via de pointer toegankelijk is. Geef npos niet door als bufferlengte. Geef je data() en size() door aan een interface die een pointer en een lengte verwacht, controleer dan haar eisen aan het bereik en de levensduur van de gegevens.

Voorbeelden

#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';
    }
}

Resultaat

mode: fast
missing '='

Het eerste record wordt gesplitst in de sleutel `mode` en de waarde `fast`, met een dubbele punt ertussen in de uitvoer. In het tweede record ontbreekt `=`, dus het programma meldt de fout voordat het de beginpositie van de waarde berekent.

Gerelateerde lessen

  • C++ · Les 58 · Gevorderd · Versie: 3

Bronnen