CKTIS / C++
`std::string::npos` : aucune correspondance ou longueur jusqu’à la fin
Comparez le résultat de `std::string::find` à `std::string::npos`. Comme nombre de caractères dans `substr` ou `erase`, cette constante signifie « jusqu’à la fin », et non une position de départ.
Version : ISO C++23; implementation support may vary
Syntaxe
#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 hereEn C++23, std::string::npos est un membre static constexpr de type std::string::size_type, accessible via <string>. Convertir -1 vers ce type non signé donne sa plus grande valeur représentable. Ce n’est pas un indice négatif ; ne supposez ni largeur de type ni valeur décimale particulière.
input.find('#') sélectionne la surcharge pour un caractère unique. Par défaut, elle cherche à partir de l’indice 0 et renvoie l’indice de la première occurrence ou std::string::npos s’il n’y en a pas. Conservez le résultat avec auto ou std::string::size_type : pos == std::string::npos signifie qu’il n’y a pas de correspondance et pos != std::string::npos qu’il y en a une. N’utilisez pas if (pos) : l’indice valide 0 donne false, tandis que npos donne true.
Le sens dépend de l’argument. s.substr(start, std::string::npos) renvoie une chaîne distincte de start jusqu’à la fin ; s.erase(start, std::string::npos) supprime cette partie de s. Dans les deux appels, start ne doit pas dépasser s.size(), sinon la fonction lève std::out_of_range. Vérifiez qu’il y a une correspondance avant d’utiliser le résultat comme indice ou position de départ, ou de faire un calcul avec lui.
Exemples
#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);
}
Résultat
Rejected at index 0 Accepted: draft!
Dans `#draft`, `#` est à l’indice `0` : la fonction rejette l’entrée avant d’en copier le contenu ou de modifier une chaîne. Dans `draft`, il n’y a pas de `#` ; la fonction copie l’entrée et ajoute `!` à la copie, sans changer l’original.
Leçons associées
- C++ · Leçon 15 · Avancé · Version : 3
Sources
- 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