Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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