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

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

Fontes