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

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

Fontes