Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::istringstream — ler valores de texto

std::istringstream permite ler valores de texto em memória através do operador >>. Segue as mesmas regras de formatação e convenções de estado de erro que outros fluxos de entrada, sem abrir um ficheiro.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::istringstream, declarado em <sstream>, é um alias de std::basic_istringstream<char>. Fornece entrada em fluxo a partir de um buffer de texto em memória. É útil para dividir uma linha em palavras e números; ao contrário de std::ostringstream, lê texto em vez de criar texto de saída.

Crie o fluxo a partir do texto e, em seguida, extraia valores com >>. Por predefinição, a extração formatada ignora os espaços em branco iniciais, e a extração para std::string termina antes do espaço em branco seguinte. A interpretação dos números depende da locale do fluxo. O exemplo seleciona explicitamente std::locale::classic() e escreve Ada 42 seguido de uma mudança de linha.

Verifique o resultado da extração: if (input >> value) ou while (input >> value). A condição é falsa quando failbit ou badbit está definido. Só o eofbit não significa que a extração falhou: o último valor pode ser lido com sucesso enquanto é detetado o fim da entrada. Não controle o ciclo com while (!input.eof()). Uma extração numérica bem-sucedida também não prova que todo o texto foi consumido: depois de ler um número de "12x", o x permanece no buffer.

Para reutilizar o fluxo após uma falha ou o fim da entrada, chame input.clear(); input.str("10 20");. clear() repõe os indicadores de estado, mas não remove o texto; str(...) substitui o texto, mas não repõe esses indicadores. Esta entrada utiliza funcionalidades disponíveis em C++23; o projeto de norma citado é um documento em evolução, não uma especificação C++23 definitiva.

Exemplos

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

Resultado

Ada 42

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes