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

CKTIS / C

EXIT_SUCCESS e EXIT_FAILURE — estado de terminação

As macros EXIT_SUCCESS e EXIT_FAILURE de <stdlib.h> assinalam de forma portável o sucesso ou a falha de um programa.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdlib.h>

/* In main: */
return EXIT_SUCCESS;
return EXIT_FAILURE;

/* To terminate the program: */
exit(EXIT_SUCCESS);
exit(EXIT_FAILURE);

EXIT_SUCCESS e EXIT_FAILURE, de <stdlib.h>, expandem para expressões constantes inteiras. Indicam, respetivamente, a terminação bem-sucedida e a terminação sem sucesso do programa.

Passe-as a exit ou devolva-as na chamada inicial de main, quando esta devolve um int. Devolver um estado a partir de outra função não termina, por si só, o programa.

0 também indica sucesso. Não assuma que EXIT_SUCCESS == 0 ou EXIT_FAILURE == 1; o mapeamento do estado para o ambiente anfitrião é definido pela implementação. Um valor diferente qualquer não garante de forma portável uma falha.

Exemplos

#include <stdlib.h>

int main(void)
{
    const int expected = 42;
    const int actual = 6 * 7;

    if (actual != expected) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

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