Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::basic_string::npos — nessuna corrispondenza o fino alla fine

Confronta il risultato di `find` con `npos` prima di usarlo come indice. Come parametro di lunghezza di `substr`, la stessa costante indica il resto della stringa.

Versione: ISO C++23; implementation support may vary

Sintassi

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 è un membro statico constexpr dichiarato in <string>. L’inizializzatore size_type(-1) converte -1 nel valore massimo del tipo senza segno size_type della specializzazione. Non è un numero negativo né la lunghezza corrente size(). Per std::string, scrivi std::string::npos.

find restituisce l’indice della prima corrispondenza, contando da zero, oppure npos se non ce ne sono. Conserva il risultato con auto o size_type, non con int, e confrontalo con npos prima di usarlo come indice o di calcolare pos + 1. Se il separatore è obbligatorio, scarta il record quando manca. In rfind, invece, il valore predefinito pos = npos non impone un limite superiore alla posizione della corrispondenza; come valore restituito, npos indica ancora che non ci sono corrispondenze.

In substr(pos, count), il valore predefinito count = npos significa «da pos fino alla fine». Se il conteggio è eccessivo, viene ridotto a size() - pos, ma con pos > size() viene lanciata std::out_of_range; con pos == size() si ottiene una stringa vuota. In C++23, entrambi gli overload di substr, const & e &&, restituiscono una stringa che possiede i propri dati, non una vista.

«Fino alla fine» vale anche per append(src, pos, n) e assign(src, pos, n) quando la sorgente è un basic_string. Invece, append(ptr, n) e assign(ptr, n) richiedono un numero effettivo di elementi accessibili tramite il puntatore. Non passare npos come lunghezza di un buffer. Se fornisci data() e size() a un’interfaccia che riceve un puntatore e una lunghezza, controlla i requisiti sull’intervallo e sulla durata di vita dei dati.

Esempi

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

Risultato

mode: fast
missing '='

Dal primo record si ricavano la chiave `mode` e il valore `fast`, stampati con i due punti come separatore. Nel secondo manca `=`, quindi il programma segnala l’errore prima di calcolare la posizione iniziale del valore.

Lezioni correlate

  • C++ · Lezione 58 · Avanzato · Versione: 3

Fonti