Library initialization and termination

Functions
apr_status_t	apr_initialize (void)
apr_status_t	apr_app_initialize (int *argc, char const *const **argv, char const *const **env)
void	apr_terminate (void)
void	apr_terminate2 (void)

---

Function Documentation

apr_status_t apr_app_initialize	(	int *	argc,
		char const *const **	argv,
		char const *const **	env
	)

Set up an application with normalized argc, argv (and optionally env) in order to deal with platform-specific oddities, such as Win32 services, code pages and signals. This must be the first function called for any APR program.

Parameters:

	argc	Pointer to the argc that may be corrected
	argv	Pointer to the argv that may be corrected
	env	Pointer to the env that may be corrected, may be NULL

Remarks:

See apr_initialize if this is a library consumer of apr. Otherwise, this call is identical to apr_initialize, and must be closed with a call to apr_terminate at the end of program execution.

apr_status_t apr_initialize

(

void

)

Setup any APR internal data structures. This MUST be the first function called for any APR library. It is safe to call apr_initialize several times as long as apr_terminate is called the same number of times.

Remarks:

See apr_app_initialize if this is an application, rather than a library consumer of apr.

void apr_terminate

(

void

)

Tear down any APR internal data structures which aren't torn down automatically. apr_terminate must be called once for every call to apr_initialize() or apr_app_initialize().

Remarks:

An APR program must call this function at termination once it has stopped using APR services. The APR developers suggest using atexit to ensure this is called. When using APR from a language other than C that has problems with the calling convention, use apr_terminate2() instead.

void apr_terminate2

(

void

)

Tear down any APR internal data structures which aren't torn down automatically, same as apr_terminate

Remarks:

An APR program must call either the apr_terminate or apr_terminate2 function once it it has finished using APR services. The APR developers suggest using atexit(apr_terminate) to ensure this is done. apr_terminate2 exists to allow non-c language apps to tear down apr, while apr_terminate is recommended from c language applications.