Apache Portable Runtime
Functions
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:
argcPointer to the argc that may be corrected
argvPointer to the argv that may be corrected
envPointer 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.
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Defines