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