Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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