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

CKTIS / Java

Scanner.nextDouble() — ler um valor do tipo double

`Scanner.nextDouble()` lê o token seguinte como um valor primitivo do tipo `double`. As definições regionais do scanner determinam os separadores numéricos que este reconhece.

Versão: Java SE 21

Sintaxe

public double nextDouble()

// Call on an existing java.util.Scanner instance:
double value = scanner.nextDouble();

Scanner.nextDouble() é um método de instância de java.util.Scanner que não recebe argumentos. A chamada scanner.nextDouble() ignora os delimitadores antes do token seguinte, converte esse token num valor primitivo do tipo double e avança para depois do token se a conversão for bem-sucedida. Por omissão, os delimitadores são caracteres de espaço em branco, como espaços e quebras de linha.

Inicialmente, o scanner usa as definições regionais de formatação predefinidas (Locale.Category.FORMAT). As suas definições regionais afetam a leitura de números, incluindo o reconhecimento dos separadores decimais e dos separadores de grupos de algarismos. Usa scanner.useLocale(Locale.US) se os dados de entrada usarem um ponto decimal, como em 12.5.

Se o token seguinte não corresponder ao formato esperado ou não puder ser convertido num double, o método lança InputMismatchException sem consumir o token. Ultrapassar o intervalo dos valores finitos de tipo double não provoca, por si só, esta exceção: com Locale.US, o método consome o token 1e309 e devolve Double.POSITIVE_INFINITY. Lança NoSuchElementException se a entrada tiver chegado ao fim e IllegalStateException se o scanner estiver fechado. hasNextDouble() verifica o token seguinte sem o consumir. Se devolver false, usa hasNext() para distinguir um token inválido do fim da entrada. Se houver um token, podes ignorá-lo com next(). Com entrada interativa, tanto a verificação como a leitura podem ficar à espera de mais dados.

nextDouble() lê um token, não uma linha inteira. Se houver uma quebra de linha imediatamente a seguir ao número, uma chamada a nextLine() devolve uma cadeia de caracteres vazia. Fechar o scanner também fecha a sua fonte se esta implementar Closeable; por isso, fechar um scanner criado a partir de System.in fecha a entrada padrão.

Exemplos

import java.util.Locale;
import java.util.Scanner;

public class Main {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner("12.5 -3.25")) {
            scanner.useLocale(Locale.US);
            double first = scanner.nextDouble();
            double second = scanner.nextDouble();
            System.out.println(first);
            System.out.println(second);
        }
    }
}

Resultado

12.5
-3.25

O programa lê a partir de uma cadeia de caracteres fixa, por isso não é preciso escrever nada. `Locale.US` permite reconhecer o ponto decimal independentemente das definições regionais de formatação predefinidas. As duas chamadas a `nextDouble()` leem `12.5` e `-3.25` por esta ordem, e o bloco `try` fecha o scanner automaticamente.

Lições relacionadas

  • Java · Lição 2 · Básico · Versão: 2

Fontes