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

CKTIS / C

atexit — função de biblioteca C23

`atexit(void (*func)(void))` de `<stdlib.h>` regista uma função sem argumentos para chamada durante a terminação normal. Devolve zero em sucesso e valor não zero se o registo falhar.

Versão: C23

Sintaxe

int atexit(void (*func)(void));

atexit(void (*func)(void)) de <stdlib.h> regista uma função sem argumentos para chamada durante a terminação normal. Devolve zero em sucesso e valor não zero se o registo falhar.

Serve para a limpeza final de recursos do processo que não pode seguir convenientemente o fluxo local. O exemplo regista dois tratadores distintos, verifica os dois resultados e deixa o retorno de main chamar second e depois first.

A implementação tem de suportar pelo menos 32 registos e cada registo bem-sucedido, mesmo repetido para a mesma função, produz uma chamada. A ordem é normalmente inversa, exceto que um tratador registado durante a terminação é chamado depois dos tratadores antes registados que já tinham sido chamados nesse momento. Sair por longjmp tem comportamento indefinido; abort, _Exit e quick_exit não executam estes tratadores.

Exemplos

#include <stdio.h>
#include <stdlib.h>

static void first(void) { puts("first"); }
static void second(void) { puts("second"); }

int main(void) {
    if (atexit(first) != 0 || atexit(second) != 0) return EXIT_FAILURE;
    puts("body");
    return EXIT_SUCCESS;
}

Resultado

body
second
first

Serve para a limpeza final de recursos do processo que não pode seguir convenientemente o fluxo local. O exemplo regista dois tratadores distintos, verifica os dois resultados e deixa o retorno de `main` chamar `second` e depois `first`.

Fontes