Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::istringstream — leggere valori dal testo

std::istringstream consente di leggere valori da testo in memoria tramite l’operatore >>. Segue le stesse regole di formattazione e convenzioni sullo stato di errore degli altri flussi di input, senza aprire un file.

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

Sintassi

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

std::istringstream, dichiarato in <sstream>, è un alias di std::basic_istringstream<char>. Fornisce input a flusso da un buffer di testo in memoria. È utile per suddividere una riga in parole e numeri; a differenza di std::ostringstream, legge testo invece di creare testo di output.

Crea il flusso a partire dal testo, quindi estrai i valori con >>. Per impostazione predefinita, l’estrazione formattata salta i caratteri di spaziatura iniziali e l’estrazione in std::string si ferma prima del successivo carattere di spaziatura. L’interpretazione dei numeri dipende dalle impostazioni locali del flusso. L’esempio seleziona esplicitamente std::locale::classic() e stampa Ada 42 seguito da un carattere di nuova riga.

Controlla il risultato dell’estrazione: if (input >> value) oppure while (input >> value). La condizione è falsa quando è impostato failbit o badbit. Il solo eofbit non significa che l’estrazione sia fallita: l’ultimo valore può essere letto correttamente mentre viene rilevata la fine dell’input. Non controllare il ciclo con while (!input.eof()). Inoltre, un’estrazione numerica riuscita non dimostra che sia stato consumato tutto il testo: dopo aver letto un numero da "12x", la x rimane nel buffer.

Per riutilizzare il flusso dopo un errore o la fine dell’input, chiama input.clear(); input.str("10 20");. clear() azzera i flag di stato, ma non rimuove il testo; str(...) sostituisce il testo, ma non azzera quei flag. Questa voce usa funzionalità disponibili in C++23; la bozza di lavoro citata è un documento in evoluzione, non una specifica C++23 definitiva.

Esempi

#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';
}

Risultato

Ada 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti