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

CKTIS / Java

Fechar um scanner: Scanner.close()

`Scanner.close()` fecha um scanner e pode também fechar a respetiva fonte de dados. Tem isso em conta quando a entrada padrão é partilhada.

Versão: Java SE 21

Sintaxe

public void close()

scanner.close();

Em Java SE 21, Scanner.close é um método de instância de java.util.Scanner. Chama scanner.close() quando já não precisares desse scanner. O método não aceita argumentos, não devolve qualquer valor e não declara exceções verificadas. Voltar a chamá-lo não tem efeito.

Depois de fechado o scanner, os métodos de leitura e pesquisa, como next() e hasNext(), lançam IllegalStateException. Não é o mesmo que chegar ao fim da entrada: se o scanner estiver aberto e não houver outro token, hasNext() devolve false.

Ao fechar pela primeira vez, o scanner chama também close() no objeto Readable subjacente, se este implementar java.io.Closeable. Ao fechar um scanner criado com new Scanner(System.in), é chamado close() no fluxo que System.in referenciava no momento da criação do scanner. O efeito depende de como esse fluxo implementa close(). Não feches esse scanner enquanto outra parte do programa precisar desse fluxo.

Quando o teu código é responsável por fechar um recurso gerido pelo scanner, como um ficheiro aberto para a tarefa atual, usa try-with-resources. O Java chama close() ao sair do bloco, mesmo que a saída se deva a uma exceção.

Exemplos

import java.util.Scanner;

public class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner("alpha beta");
        System.out.println(scanner.next());

        scanner.close();
        scanner.close();

        try {
            scanner.hasNext();
        } catch (IllegalStateException e) {
            System.out.println("IllegalStateException");
        }
    }
}

Resultado

alpha
IllegalStateException

O scanner lê uma cadeia de caracteres fixa, não `System.in`. O programa escreve `alpha`, chama `close()` duas vezes e apanha a exceção de `hasNext()`, apesar de `beta` não ter sido lido.

Lições relacionadas

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

Fontes