_onexit, _onexit_m

Registra uma rotina a ser chamada na hora de saída.

Sintaxe

_onexit_t _onexit(
   _onexit_t function
);
_onexit_t_m _onexit_m(
   _onexit_t_m function
);

Parâmetros

function
Ponteiro para uma função a ser chamada na saída.

Valor retornado

_onexit Retorna um ponteiro para a função se for bem-sucedido ou NULL se não houver espaço para armazenar o ponteiro da função.

Comentários

A função _onexit é passada para o endereço de uma função (function) a ser chamada quando o programa terminar normalmente. Chamadas sucessivas para _onexit criam um registro das funções que são executadas em ordem UEPS (último a entrar, primeiro a sair). As funções passadas para _onexit não podem receber parâmetros.

No caso em que _onexit é chamado de dentro de uma DLL, as rotinas registradas com _onexit são executadas quando a DLL é descarregada, depois DllMain é chamado com DLL_PROCESS_DETACH.

_onexit é uma extensão da Microsoft. Para portabilidade ANSI, use atexit. A versão _onexit_m da função destina-se ao uso de modo misto.

Requisitos

Rotina	Cabeçalho necessário
_onexit	<stdlib.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_onexit.c

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

/* Prototypes */
int fn1(void), fn2(void), fn3(void), fn4 (void);

int main( void )
{
   _onexit( fn1 );
   _onexit( fn2 );
   _onexit( fn3 );
   _onexit( fn4 );
   printf( "This is executed first.\n" );
}

int fn1()
{
   printf( "next.\n" );
   return 0;
}

int fn2()
{
   printf( "executed " );
   return 0;
}

int fn3()
{
   printf( "is " );
   return 0;
}

int fn4()
{
   printf( "This " );
   return 0;
}

Saída

This is executed first.
This is executed next.

Confira também

Controle de processo e ambiente
atexit
exit, _Exit, _exit
__dllonexit