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

CKTIS / C++

std::cin: ler com verificação de erros

std::cin é o fluxo de entrada padrão. A extração com >> tenta interpretar os dados como o tipo pedido, pelo que é necessário verificar o resultado.

Versão: C++23

Sintaxe

if (std::cin >> value) { /* use value */ }

Inclui <iostream> e verifica a extração completa, por exemplo if (std::cin >> value). A extração formatada normalmente ignora espaços iniciais; ler uma cadeia com >> termina num separador. std::getline lê uma linha inteira. Depois de um número pode ficar uma mudança de linha no fluxo, consumida imediatamente pela leitura de linha seguinte.

Não uses while (!std::cin.eof()) para prever se a próxima leitura terá sucesso. O fim dos dados ou um formato inválido podem definir um estado de erro. Num erro recuperável, std::cin.clear() limpa os indicadores, mas não os dados inválidos. std::cin.ignore pode descartar o resto da linha atual; não repitas indefinidamente a leitura após um verdadeiro fim de entrada.

Os exemplos ligam temporariamente std::cin ao buffer de um std::istringstream com texto fixo e depois repõem o buffer anterior. Assim, os resultados são reproduzíveis sem teclado. A entrada normal vem do utilizador ou de um redirecionamento. Ler um número com sucesso não valida o seu intervalo de negócio nem confirma a ausência de caracteres adicionais a seguir.

Exemplos

#include <iostream>
#include <sstream>
#include <string>
#include <limits>

int main() {
    std::istringstream supplied("7 12\nAda Lovelace\n");
    auto* previous = std::cin.rdbuf(supplied.rdbuf());
    int first{}, second{};
    std::string name;
    if (std::cin >> first >> second) {
        std::cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n');
        if (std::getline(std::cin, name)) {
            std::cout << first + second << '\n' << name << '\n';
        }
    }
    std::cin.rdbuf(previous);
}

Resultado

19
Ada Lovelace
#include <iostream>
#include <sstream>
#include <limits>

int main() {
    std::istringstream supplied("wrong\n8\n");
    auto* previous = std::cin.rdbuf(supplied.rdbuf());
    int value{};
    if (!(std::cin >> value)) {
        std::cout << "invalid\n";
        std::cin.clear();
        std::cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n');
    }
    if (std::cin >> value) std::cout << value << '\n';
    std::cin.rdbuf(previous);
}

Resultado

invalid
8

Fontes