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
- 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