CKTIS / Java
Scanner.nextLine() — Ler o resto da linha atual
`Scanner.nextLine()` devolve o resto da linha atual sem o separador de linha. Logo após `nextInt()`, o resultado pode ser uma cadeia de caracteres vazia.
Versão: Java SE 21
Sintaxe
public String nextLine()
String line = scanner.nextLine();Scanner.nextLine é um método de instância de java.util.Scanner. Não recebe argumentos nem tem sobrecargas. Chama-o num objeto, por exemplo com scanner.nextLine(). Devolve uma String desde a posição atual até ao fim da linha: mantém os espaços, não inclui o separador de linha no resultado e avança para lá desse separador, se existir. Também pode ler uma última linha não vazia mesmo que não tenha um separador no fim.
next() e nextInt() leem tokens, ou seja, partes da entrada delimitadas pelo padrão usado para separar tokens. nextLine() não usa esse padrão. nextInt() só consegue ler o número se, segundo o padrão em uso, o número inteiro constituir um token completo. Com o separador predefinido, 42Ada é um único token, pelo que nextInt() lança InputMismatchException. Com um padrão personalizado, uma quebra de linha não separa necessariamente tokens. Se a leitura for bem-sucedida, nextInt() deixa a posição logo após o token. Se aí começar um separador de linha, nextLine() devolve "", não o texto da linha seguinte. Se ainda houver texto ou espaços na mesma linha, nextLine() devolve-os. Ignora o resultado apenas se quiseres saltar o resto dessa linha.
hasNextLine() verifica se ainda há uma linha para ler sem alterar a posição. Uma linha vazia com separador não é o fim da entrada. Se não houver nenhuma linha para ler, nextLine() lança NoSuchElementException. Ambos os métodos lançam IllegalStateException se o scanner estiver fechado.
Ambos os métodos podem ficar bloqueados à espera de dados. Se não houver um separador de linha na entrada restante, nextLine() pode guardá-la toda num buffer. Fechar o scanner também fecha a respetiva fonte se esta implementar Closeable. Não feches um scanner ligado a System.in se o programa ainda precisar da entrada padrão.
Exemplos
import java.util.Scanner;
public class Main {
public static void main(String[] args) {
try (Scanner scanner = new Scanner("42\r\nAda Lovelace")) {
int number = scanner.nextInt();
String rest = scanner.nextLine();
System.out.println(number);
System.out.println("[" + rest + "]");
while (scanner.hasNextLine()) {
System.out.println("[" + scanner.nextLine() + "]");
}
}
}
}Resultado
42 [] [Ada Lovelace]
A entrada vem de uma cadeia de caracteres, não do teclado. Os parênteses retos delimitam o resultado: `[]` representa o resto vazio após `42`, e `[Ada Lovelace]` mostra que a última linha é lida com o seu espaço mesmo sem separador final.
Lições relacionadas
- Java · Lição 2 · Básico · Versão: 2