Namespaces
Variants
Views
Actions

exit

From cppreference.com
< c‎ | program
Revision as of 04:07, 22 April 2014 by Newatthis (Talk | contribs)

Defined in header <stdlib.h>
void exit( int exit_code );

Causes normal program termination to occur.

Several cleanup steps are performed:

  • functions passed to atexit are called.
  • all C streams are flushed and closed
  • files created by tmpfile are removed
  • control is returned to the host environment. If exit_code is EXIT_SUCCESS, an implementation-defined status, indicating successful termination is returned. If exit_code is EXIT_FAILURE, an implementation-defined status, indicating unsuccessful termination is returned. In other cases implementation-defined status value is returned.

Contents

Parameters

exit_code - exit status of the program

Return value

(none)

Example

#include <stdio.h>      /* FILE, fopen, fclose, fprintf, printf */
#include <stdlib.h>     /* exit */
 
int main(void)
{
    FILE *fp = fopen("data.txt","r");
    if (fp == NULL) {
       fprintf(stderr, "error opening file data.txt in function main()\n");
       exit(1);
    }
 
    /* Normal processing continues here. */
    fclose(fp);
    printf("Normal Return\n");
    return 0;
}

Output:

error opening file data.txt in function main()

See also

causes abnormal program termination (without cleaning up)
(function) [edit]
registers a function to be called on exit() invocation
(function) [edit]
causes normal program termination without completely cleaning up
(function) [edit]