CKTIS / C++
std::basic_string::npos — brak dopasowania lub odczyt do końca
Wynik `find` równy `npos` oznacza brak dopasowania. W parametrze liczby elementów funkcji `substr` ta sama stała oznacza pobranie reszty napisu.
Wersja: ISO C++23; implementation support may vary
Składnia
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 to statyczna stała constexpr zadeklarowana w <string>. Zapis size_type(-1) przekształca -1 w największą wartość bez znaku typu size_type danej specjalizacji. Nie jest to liczba ujemna ani bieżące size(). Dla std::string używaj std::string::npos.
find zwraca indeks pierwszego dopasowania, licząc od zera, albo npos, jeśli nie ma dopasowania. Zachowaj wynik w auto lub size_type, a nie w int, i porównaj go z npos przed indeksowaniem lub obliczeniem pos + 1. Jeśli separator jest obowiązkowy, jego brak oznacza odrzucenie rekordu. Z kolei w rfind domyślne pos = npos nie ogranicza od góry pozycji dopasowania; zwrócone npos nadal oznacza brak dopasowania.
W substr(pos, count) domyślne count = npos oznacza „od pos do końca”. Za duże count jest ograniczane do size() - pos, lecz pos > size() powoduje std::out_of_range; przy pos == size() wynik jest pusty. W C++23 oba przeciążenia substr, const & i &&, zwracają napis posiadający własne dane, nie widok.
Znaczenie „do końca” dotyczy też przeciążeń append(src, pos, n) i assign(src, pos, n) ze źródłem typu basic_string. Natomiast append(ptr, n) i assign(ptr, n) wymagają rzeczywistej liczby elementów dostępnych przez wskaźnik. Nie przekazuj npos jako długości bufora. Jeśli odbiorca pobiera wskaźnik i długość z data() oraz size(), sprawdź jego wymagania dotyczące zakresu i czasu życia danych.
Przykłady
#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';
}
}
Wynik
mode: fast missing '='
Dwukropek w wyjściu oddziela klucz `mode` od wartości `fast`. W drugim rekordzie brakuje `=`, więc program zgłasza błąd przed obliczeniem pozycji wartości.
Powiązane lekcje
- C++ · Lekcja 58 · Zaawansowany · Wersja: 3
Źródła
- 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