CKTIS / C++
std::basic_string::npos — nicht gefunden oder bis zum Ende
Prüfe das Ergebnis von `find` auf `npos`, bevor du es als Index verwendest. Als Anzahl für `substr` steht dieselbe Konstante für den Rest der Zeichenkette.
Version: 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 ist ein statisches constexpr-Member, das in <string> deklariert ist. size_type(-1) wandelt -1 in den größten Wert des vorzeichenlosen size_type der jeweiligen Spezialisierung um. Der Wert ist weder negativ noch gleich der aktuellen Länge size(). Für std::string schreibst du std::string::npos.
find liefert den nullbasierten Index des ersten Treffers oder npos, wenn es keinen Treffer gibt. Speichere das Ergebnis mit auto oder size_type, nicht mit int, und vergleiche es mit npos, bevor du es als Index verwendest oder pos + 1 berechnest. Fehlt ein Pflichttrennzeichen, verwirf den Datensatz. Bei rfind setzt der Standardwert pos = npos dagegen keine Obergrenze für die Trefferposition; als Rückgabewert bedeutet npos weiterhin „kein Treffer“.
Bei substr(pos, count) bedeutet der Standardwert count = npos „ab pos bis zum Ende“. Eine zu große Anzahl wird auf size() - pos begrenzt. Bei pos > size() wird std::out_of_range ausgelöst, bei pos == size() ist das Ergebnis leer. In C++23 geben beide Überladungen von substr, const & und &&, eine Zeichenkette mit eigenem Speicher zurück, keine View.
„Bis zum Ende“ gilt auch für append(src, pos, n) und assign(src, pos, n) mit einem basic_string als Quelle. append(ptr, n) und assign(ptr, n) erwarten dagegen eine tatsächliche Anzahl von Elementen, die über den Zeiger zugänglich sind. Übergib npos nicht als Pufferlänge. Wenn du data() und size() an eine Schnittstelle mit Zeiger und Länge übergibst, prüfe deren Anforderungen an Bereich und Lebensdauer.
Beispiele
#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';
}
}
Ergebnis
mode: fast missing '='
Der erste Datensatz wird in den Schlüssel `mode` und den Wert `fast` zerlegt und mit einem Doppelpunkt ausgegeben. Im zweiten fehlt `=`, weshalb das Programm den Fehler meldet, bevor es den Beginn des Werts berechnet.
Zugehörige Lektionen
- C++ · Lektion 58 · Fortgeschritten · Version: 3
Quellen
- 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