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

CKTIS / C++

std::stoi — convertir du texte en int

std::stoi de <string> convertit la partie initiale d’un texte en int. Elle permet de préciser la base numérique et de récupérer la position où la conversion s’est arrêtée. Il n’est pas nécessaire de consommer toute la chaîne et les erreurs sont signalées par des exceptions.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <string>

/* Overload synopsis (declarations provided by <string>):
namespace std {
    int stoi(const string& str, size_t* idx = nullptr, int base = 10);
    int stoi(const wstring& str, size_t* idx = nullptr, int base = 10);
}
*/

std::stoi, déclarée dans <string>, renvoie une valeur de type int lue dans un texte. Des surcharges acceptent std::string et std::wstring. Le paramètre base indique la base numérique et vaut 10 par défaut. Les seules valeurs admises sont 0 (détection automatique de la base) et les entiers compris entre 2 et 36 inclus. Toute autre valeur est hors du domaine défini pour la conversion sous-jacente. Si base provient d’une source non fiable, vérifiez sa valeur avant l’appel : intercepter std::invalid_argument et std::out_of_range n’est pas une manière portable de valider la base.

La conversion peut s’arrêter avant la fin du texte : "42px" produit 42, sans erreur. Après un appel réussi avec idx != nullptr, la fonction stocke dans *idx l’indice du premier élément non converti. La valeur par défaut nullptr ignore cette information. Si la chaîne entière doit être consommée, vérifiez pos == text.size() après une conversion réussie.

Si aucune conversion n’est possible, la fonction lance std::invalid_argument. Un résultat hors de la plage de int, ou une erreur de plage dans la conversion sous-jacente, provoque std::out_of_range. Gérez ces deux exceptions lors du traitement de données non fiables ; après une exception, ne considérez pas idx comme un résultat de conversion.

L’exemple affiche 42, puis l’indice 2, puis le reste px. Il montre la différence entre convertir avec succès une partie initiale et valider toute l’entrée. La documentation source est un projet de travail évolutif, et non une édition figée de C++23 ; l’exemple est destiné à une vérification locale en mode C++23, sans attester d’un environnement de production.

Exemples

#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string>

int main() {
    const std::string text = "42px";
    std::size_t pos = 0;

    try {
        const int value = std::stoi(text, &pos, 10);
        std::cout << value << '\n';
        std::cout << pos << '\n';
        std::cout << text.substr(pos) << '\n';
    } catch (const std::invalid_argument&) {
        std::cout << "invalid_argument\n";
    } catch (const std::out_of_range&) {
        std::cout << "out_of_range\n";
    }
}

Résultat

42
2
px

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources