CKTIS / Java
Scanner.useLocale — definições regionais para ler números
Define as convenções regionais de um scanner para ler números conforme a notação dos dados de entrada, por exemplo com vírgula decimal.
Versão: Java SE 21
Sintaxe
public Scanner useLocale(Locale locale)
scanner.useLocale(Locale.GERMANY);Scanner.useLocale é um método de instância de java.util.Scanner. Recebe um objeto java.util.Locale, não uma cadeia de caracteres. Altera apenas as definições regionais desse scanner e devolve o mesmo objeto, pelo que podes encadear uma chamada a nextDouble(). Não altera as definições regionais predefinidas da JVM.
Escolhe as definições regionais antes de ler um número para corresponder à notação dos dados de entrada, incluindo os separadores decimal e de agrupamento de algarismos. useLocale não altera o delimitador de tokens nem o formato da saída. Consulta a configuração atual com locale(). Um scanner novo começa com Locale.getDefault(Locale.Category.FORMAT); reset() repõe a configuração predefinida de FORMAT, bem como o delimitador e a base numérica predefinidos.
hasNextDouble() verifica o próximo token sem o consumir. Se nextDouble() não conseguir ler um token existente como double, lança InputMismatchException e deixa o token por consumir. Se os dados de entrada estiverem esgotados, lança NoSuchElementException; se o scanner estiver fechado, lança IllegalStateException.
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 12.5")) {
double german = scanner.useLocale(Locale.GERMANY).nextDouble();
double us = scanner.useLocale(Locale.US).nextDouble();
System.out.println(german);
System.out.println(us);
}
}
}Resultado
12.5 12.5
O mesmo scanner lê `12,5` com `Locale.GERMANY` e depois `12.5` com `Locale.US`. Ambas as notações produzem o mesmo valor de tipo `double`. `println(double)` escreve `12.5` com um ponto nas duas linhas, sem usar as definições regionais do scanner.
Lições relacionadas
- Java · Lição 2 · Básico · Versão: 2