CKTIS / C++
std::basic_string::npos — aucune correspondance ou jusqu’à la fin
Comparez le résultat de `find` à `npos` avant de l’utiliser comme indice. Dans le paramètre de longueur de `substr`, cette même constante désigne le reste de la chaîne.
Version : ISO C++23; implementation support may vary
Syntaxe
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 est un membre statique constexpr déclaré dans <string>. L’initialisation size_type(-1) convertit -1 en la plus grande valeur du type non signé size_type de la spécialisation. Ce n’est ni un nombre négatif ni la longueur courante size(). Pour std::string, écrivez std::string::npos.
find renvoie l’indice de la première correspondance, en comptant à partir de zéro, ou npos s’il n’y en a aucune. Conservez le résultat avec auto ou size_type, pas avec int, et comparez-le à npos avant de l’utiliser comme indice ou de calculer pos + 1. Si un séparateur est obligatoire, rejetez l’enregistrement qui en est dépourvu. À l’inverse, la valeur par défaut pos = npos de rfind ne fixe aucune borne supérieure à la position de la correspondance ; en retour, npos signifie toujours qu’il n’y en a aucune.
Dans substr(pos, count), la valeur par défaut count = npos signifie « de pos jusqu’à la fin ». Un nombre trop grand est ramené à size() - pos, mais pos > size() déclenche std::out_of_range ; avec pos == size(), la chaîne obtenue est vide. En C++23, les deux surcharges const & et && de substr renvoient une chaîne qui possède ses données, pas une vue.
« Jusqu’à la fin » s’applique aussi à append(src, pos, n) et assign(src, pos, n) lorsque la source est un basic_string. En revanche, append(ptr, n) et assign(ptr, n) exigent un nombre réel d’éléments accessibles via le pointeur. Ne passez pas npos comme longueur de tampon. Si vous transmettez un pointeur et une longueur issus de data() et size(), vérifiez les exigences de l’interface concernant la plage et la durée de vie des données.
Exemples
#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';
}
}
Résultat
mode: fast missing '='
Le programme sépare le premier enregistrement en une clé `mode` et une valeur `fast`, affichées avec un deux-points. Le second ne contient pas `=` : le programme signale l’erreur avant de calculer le début de la valeur.
Leçons associées
- C++ · Leçon 58 · Avancé · Version : 3
Sources
- 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