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

CKTIS / Java

void — um método sem valor de retorno

A palavra-chave `void` indica que um método não devolve qualquer valor. Ainda assim, o método pode realizar ações, como apresentar texto. Não confunda `void` com o valor `null` nem com a classe `java.lang.Void`.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

void methodName() { /* statements */ }

void é uma palavra-chave reservada de Java. Na declaração de um método, ocupa o lugar do tipo de retorno e indica que não é devolvido qualquer valor. Não é um tipo que possa ser usado para declarar uma variável ou um parâmetro. Também não significa que o método não faça nada: pode, por exemplo, alterar o estado de um objeto ou apresentar texto.

Um método declarado como void pode terminar ao chegar ao fim do seu corpo ou usar return; para sair mais cedo. Não pode usar return expression;, mesmo quando a expressão é null. Um construtor não declara qualquer resultado; acrescentar void cria um método, não um construtor.

Uma chamada a um método void não fornece qualquer valor, pelo que não pode atribuir o seu resultado a uma variável nem usá-lo como argumento quando é necessário um valor. void não é o mesmo que null: null é um valor de referência. A classe java.lang.Void é um marcador não instanciável usado para representar void na reflexão, não um valor devolvido por métodos void.

No exemplo, printPositive(0) termina em return;, enquanto printPositive(7) apresenta 7. Nenhuma das chamadas devolve um valor. Em seguida, main apresenta Done.

Exemplos

public class VoidExample {
    static void printPositive(int number) {
        if (number <= 0) {
            return;
        }
        System.out.println(number);
    }

    public static void main(String[] args) {
        printPositive(0);
        printPositive(7);
        System.out.println("Done");
    }
}

Resultado

7
Done

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes