api_version.h File Reference

APR-iconv Versioning Interface. More...

Go to the source code of this file.

Defines
#define	API_MAJOR_VERSION   1
#define	API_MINOR_VERSION   2
#define	API_PATCH_VERSION   1
#define	API_IS_DEV_STRING   ""
#define	API_STRINGIFY(n)   API_STRINGIFY_HELPER(n)
#define	API_STRINGIFY_HELPER(n)   #n
#define	API_VERSION_STRING
#define	API_VERSION_STRING_CSV
Functions
	API_DECLARE (void) api_version(apr_version_t *pvsn)
	API_DECLARE (const char *) api_version_string(void)

---

Detailed Description

APR-iconv Versioning Interface.

APR-iconv's Version

There are several different mechanisms for accessing the version. There is a string form, and a set of numbers; in addition, there are constants which can be compiled into your application, and you can query the library being used for its actual version.

Note that it is possible for an application to detect that it has been compiled against a different version of API by use of the compile-time constants and the use of the run-time query function.

API version numbering follows the guidelines specified in:

http://apr.apache.org/versioning.html

Definition in file api_version.h.

---

Define Documentation

#define API_IS_DEV_STRING   ""

The symbol API_IS_DEV_VERSION is only defined for internal, "development" copies of API. It is undefined for released versions of API.

Definition at line 75 of file api_version.h.

#define API_MAJOR_VERSION   1

major version Major API changes that could cause compatibility problems for older programs such as structure size changes. No binary compatibility is possible across a change in the major version.

Definition at line 49 of file api_version.h.

#define API_MINOR_VERSION   2

minor version Minor API changes that do not cause binary compatibility problems. Reset to 0 when upgrading API_MAJOR_VERSION

Definition at line 55 of file api_version.h.

#define API_PATCH_VERSION   1

patch level The Patch Level never includes API changes, simply bug fixes. Reset to 0 when upgrading API_MINOR_VERSION

Definition at line 61 of file api_version.h.

#define API_STRINGIFY

(

n

)

API_STRINGIFY_HELPER(n)

Properly quote a value as a string in the C preprocessor

Definition at line 80 of file api_version.h.

#define API_STRINGIFY_HELPER

(

n

)

#n

Helper macro for API_STRINGIFY

Definition at line 82 of file api_version.h.

#define API_VERSION_STRING

Value:

API_STRINGIFY(API_MAJOR_VERSION) "." \
     API_STRINGIFY(API_MINOR_VERSION) "." \
     API_STRINGIFY(API_PATCH_VERSION) \
     API_IS_DEV_STRING

The formatted string of API's version

Definition at line 86 of file api_version.h.

#define API_VERSION_STRING_CSV

Value:

API_MAJOR_VERSION ##, \
                             ##API_MINOR_VERSION ##, \
                             ##API_PATCH_VERSION

An alternative formatted string of APR's version

Definition at line 94 of file api_version.h.

---

Function Documentation

API_DECLARE

(

void

)

Return APR-iconv's version information information in a numeric form.

Parameters:

pvsn	Pointer to a version structure for returning the version information.

API_DECLARE

(

const char *

)

Return API's version information as a string.