A classe Scanner
possui vários métodos com o termo next*
, como sendo:
next()
busca e retorna o próximo TOKEN completo (retorna: String
)
nextBigDecimal()
Escaneia o próximo TOKEN de um input e retorna como BigDecimal
nextBigInteger()
Escaneia o próximo TOKEN de um input e retorna como BigInteger
nextBoolean()
Analisa o próximo TOKEN de um input em retorna em um valor boolean
nextByte()
Escaneia o próximo TOKEN de um input e retorna como byte
nextDouble()
Escaneia o próximo TOKEN de um input e retorna como double
nextFloat()
Escaneia o próximo TOKEN de um input e retorna como float
nextInt()
Escaneia o próximo TOKEN de um input e retorna como int
nextLong()
Escaneia o próximo TOKEN de um input e retorna como long
nextShort()
Escaneia o próximo TOKEN de um input e retorna como short
nextLine()
Avança esse scanner além da linha atual e retorna a entrada que foi que foi "pulada" (retorna: String
)
Esquecendo o nextLine()
, note que todas falam de um tal de TOKEN, "mas o que é o TOKEN?", TOKEN ali se refere a algo que é esperado, no exemplo nextInt
espera algo que foi digitado que "case" com o int
, então se você fizer isto:
Scanner entrada = new Scanner(System.in);
int valor1 = entrada.nextInt();
int valor2 = entrada.nextInt();
int valor3 = entrada.nextInt();
System.out.println("Retornou:" + valor1);
System.out.println("Retornou:" + valor2);
System.out.println("Retornou:" + valor3);
Mas ao invés de apertar Enter você digitar:
1 2 3
E então só depois apertar o Enter, note que ele irá já exibir os 3 System.out.println
, isto porque tanto espaço quanto quebra de linha serão considerados para separar os valores, e estes valores entre as separações são os TOKENS, seja lá qual for o valor.
Agora mude para isto:
Scanner entrada = new Scanner(System.in);
String valor1 = entrada.next();
String valor2 = entrada.next();
String valor3 = entrada.next();
System.out.println("Retornou:" + valor1);
System.out.println("Retornou:" + valor2);
System.out.println("Retornou:" + valor3);
E digite isto tudo antes de apertar o Enter:
1 2 ab
Após apertar o Enter, novamente será exibido todos os 3 System.out.println
, então token em todos trabalham por espaços tanto quanto quebra de linhas.
Agora o nextLine
A minha tradução ficou um pouco ruim, o texto original da documentação é este:
Advances this scanner past the current line and returns the input that was skipped.
Eu acho que esse texto é o que confunde muita gente, ao traduzir skipped a primeira vez eu mesmo fiquei sem entender o ignorada, não é que a linha foi "ignorada", o sentido de skipped ali é que passou para a proxima linha quando executou o método, ou seja seria mais para algo como "retorna a entrada que foi da linha que foi pulada" (não sei se pulada soa bem, talvez eu revise o texto).
Então na verdade o único que trabalha com a linha inteira ao invés dos TOKENs é o nextLine
, ou seja é como se a linha inteira fosse um token, para explicar melhor usarei o seu próprio código (leia os comentários).
Procura o TOKEN (não precisa casar com int
, pode ser qualquer coisa que não seja um espaço), mas se mantem na "linha 1":
int valor1 = entrada.nextInt();
Ainda estamos na "linha 1", mas toda função next*
sempre vai trabalhar após o último TOKEN, então o 1
você ignora, só sobra o \n
ou \r\n
do input digitado, então no caso vai retornar uma String
vazia, já que quebras de linha não são valores para os TOKENs e vai passar para a "linha 2":
String texto = entrada.nextLine();
Agora estamos na "linha 2" e não na "linha 3", mas na sua "linha 2" você havia digitado abc
, o que não "casa" com o próximo comando:
int valor2 = entrada.nextInt();
Então ocorre o a exception InputMismatchException
, seguindo o input completo
123
abc
456