CKTIS / C++
`std::string::npos`: nessuna corrispondenza o conteggio fino alla fine
Confronta il risultato di `std::string::find` con `std::string::npos`. Come numero di caratteri in `substr` o `erase`, la stessa costante significa «fino alla fine», non una posizione iniziale.
Versione: ISO C++23; implementation support may vary
Sintassi
#include <string>
// Declaration inside std::basic_string in C++23:
// static constexpr size_type npos = size_type(-1);
// For an existing std::string s:
// const auto pos = s.find('#');
// pos == std::string::npos // no match
// pos != std::string::npos // match found
// s.substr(0, std::string::npos) // npos is a count hereIn C++23, std::string::npos è un membro static constexpr di tipo std::string::size_type, disponibile tramite <string>. Convertire -1 in questo tipo senza segno produce il suo massimo valore rappresentabile. Non è un indice negativo: non dare per scontati una larghezza del tipo o un valore decimale specifici.
input.find('#') seleziona l’overload per un singolo carattere. Per impostazione predefinita cerca dall’indice 0 e restituisce l’indice della prima corrispondenza oppure std::string::npos se non ne trova. Conserva il risultato con auto o std::string::size_type: pos == std::string::npos significa che non ci sono corrispondenze, mentre pos != std::string::npos indica che ne è stata trovata una. Non usare if (pos): l’indice valido 0 dà false, mentre npos dà true.
Il significato dipende dall’argomento. s.substr(start, std::string::npos) restituisce una stringa separata da start fino alla fine; s.erase(start, std::string::npos) rimuove quella parte da s. In entrambe le chiamate start non può superare s.size(), altrimenti la funzione lancia std::out_of_range. Verifica che ci sia una corrispondenza prima di usare il risultato come indice o posizione iniziale, o di fare calcoli con esso.
Esempi
#include <iostream>
#include <string>
void process(const std::string& input)
{
const auto pos = input.find('#');
if (pos != std::string::npos) {
std::cout << "Rejected at index " << pos << '\n';
return;
}
std::string result = input;
result += '!';
std::cout << "Accepted: " << result << '\n';
}
int main()
{
const std::string invalid = "#draft";
const std::string valid = "draft";
process(invalid);
process(valid);
}
Risultato
Rejected at index 0 Accepted: draft!
In `#draft`, `#` è all’indice `0`, quindi la funzione rifiuta l’input prima di copiarne il contenuto o modificare una stringa. In `draft` non c’è `#`: la funzione copia l’input e aggiunge `!` alla copia, lasciando invariato l’originale.
Lezioni correlate
- C++ · Lezione 15 · Avanzato · Versione: 3
Fonti
- C++23 working draft N4950 — [basic.string], [string.find], [string.view.find], [string.substr], [string.cons], [string.erase], [conv.integral]
- [basic.string] — Class template basic_string
- [string.find] — basic_string searching
- [string.view.find] — basic_string_view searching
- [string.substr] — basic_string::substr
- [string.erase] — basic_string::erase