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

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 here

En 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