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