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

CKTIS / Java

Scanner.nextInt(): ler um número inteiro

Lê o próximo token como `int`, verifica se é válido antes da leitura e percebe por que motivo uma chamada a `nextLine()` logo a seguir pode devolver uma cadeia vazia.

Versão: Java SE 21

Sintaxe

import java.util.Scanner;

// On an open Scanner instance named scanner:
int value = scanner.nextInt();
int hexValue = scanner.nextInt(16);

Em Java SE 21, Scanner.nextInt é um método de instância de java.util.Scanner. A chamada scanner.nextInt() ignora os delimitadores iniciais e lê um token como int. Por omissão, os delimitadores são caracteres de espaço em branco, como espaços e quebras de linha. O método não lê uma linha inteira.

nextInt() usa a base predefinida do scanner, que começa em 10 e pode ser alterada com useRadix. A sobrecarga nextInt(int radix) escolhe a base apenas para essa chamada. Por exemplo, nextInt(16) lê 2a como 42. São válidas as bases de 2 a 36; um valor fora desse intervalo provoca IllegalArgumentException. As definições regionais do scanner podem afetar os formatos numéricos aceites, incluindo o agrupamento de algarismos.

hasNextInt() verifica o próximo token sem o consumir. Para uma base explícita, usa hasNextInt(radix). Um resultado false pode indicar um token inválido ou o fim da entrada. Sem a verificação, a leitura de um token com formato incorreto ou fora do intervalo de int provoca InputMismatchException. O token continua disponível: usa next() para o descartar. O fim da entrada provoca NoSuchElementException e a leitura a partir de um scanner fechado provoca IllegalStateException.

Se ainda houver caracteres na linha atual após a leitura de um número, nextLine() devolve-os sem o separador de linha. Se a quebra de linha vier logo a seguir ao número, o resultado é "" e o scanner avança para o início da linha seguinte. Se a entrada terminar logo a seguir ao número, sem separador de linha (por exemplo, se contiver apenas 42), nextLine() lança NoSuchElementException.

O exemplo lê a partir de uma cadeia e fecha o scanner com try com recursos. Com System.in, a verificação e a leitura podem ficar à espera de dados. Fechar o scanner fecha também System.in, por isso não o feches se outra parte do programa ainda precisar desse fluxo.

Exemplos

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

public class Main {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner("42\n2a\n")) {
            scanner.useLocale(Locale.ROOT);
            if (scanner.hasNextInt()) {
                System.out.println(scanner.nextInt());
                System.out.println("[" + scanner.nextLine() + "]");
                System.out.println(scanner.nextInt(16));
            }
        }
    }
}

Resultado

42
[]
42

O primeiro `42` é lido em decimal. `[]` mostra que o resto da primeira linha está vazio, e o último `42` é o valor do token hexadecimal `2a`.

Lições relacionadas

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

Fontes