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

CKTIS / C++

std::istringstream — lire des valeurs depuis du texte

std::istringstream permet de lire des valeurs dans du texte en mémoire avec l’opérateur >>. Il suit les mêmes règles de formatage et les mêmes conventions d’état d’erreur que les autres flux d’entrée, sans ouvrir de fichier.

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

Syntaxe

#include <sstream>
std::istringstream input{"42 7"};
int value{};
while (input >> value) {
    // Use value.
}

std::istringstream, déclaré dans <sstream>, est un alias de std::basic_istringstream<char>. Il fournit une entrée par flux à partir d’un tampon de texte en mémoire. Il est utile pour découper une ligne en mots et en nombres ; contrairement à std::ostringstream, il sert à lire du texte et non à construire du texte de sortie.

Construisez le flux à partir du texte, puis extrayez les valeurs avec >>. Par défaut, l’extraction formatée ignore les espaces blancs initiaux, et l’extraction dans un std::string s’arrête avant le prochain espace blanc. L’interprétation des nombres dépend de la locale du flux. L’exemple choisit explicitement std::locale::classic() et affiche Ada 42 suivi d’un saut de ligne.

Vérifiez le résultat de l’extraction : if (input >> value) ou while (input >> value). La condition est fausse si failbit ou badbit est défini. eofbit seul ne signifie pas que l’extraction a échoué : la dernière valeur peut être lue correctement alors que la fin de l’entrée est détectée. Ne contrôlez pas la boucle avec while (!input.eof()). Une extraction numérique réussie ne prouve pas non plus que tout le texte a été consommé : après avoir lu un nombre dans "12x", le x reste dans le tampon.

Pour réutiliser le flux après un échec ou la fin de l’entrée, appelez input.clear(); input.str("10 20");. clear() réinitialise les indicateurs d’état, mais ne supprime pas le texte ; str(...) remplace le texte, mais ne réinitialise pas ces indicateurs. Cette entrée utilise des fonctionnalités disponibles en C++23 ; le projet de norme cité est un document évolutif, et non une spécification C++23 figée.

Exemples

#include <iostream>
#include <locale>
#include <sstream>
#include <string>

int main() {
    std::istringstream input{"Ada 17 25"};
    input.imbue(std::locale::classic());

    std::string name;
    int first{};
    int second{};
    if (!(input >> name >> first >> second)) {
        std::cout << "invalid input\n";
        return 1;
    }

    std::cout << name << ' ' << first + second << '\n';
}

Résultat

Ada 42

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