Version Information

Version Information — Information about the garcon version in use.

Synopsis

#include <garcon/garcon.h>

#define             GARCON_CHECK_VERSION                (major,
                                                         minor,
                                                         micro)
#define             GARCON_MAJOR_VERSION
#define             GARCON_MICRO_VERSION
#define             GARCON_MINOR_VERSION
const gchar *       garcon_check_version                (guint required_major,
                                                         guint required_minor,
                                                         guint required_micro);
gchar **            garcon_config_build_paths           (const gchar *filename);
gchar *             garcon_config_lookup                (const gchar *filename);
extern const guint  garcon_major_version;
extern const guint  garcon_micro_version;
extern const guint  garcon_minor_version;

Description

The garcon library provides version information, which could be used by developers to handle new API.

Details

GARCON_CHECK_VERSION()

#define             GARCON_CHECK_VERSION(major,minor,micro)

Checks the version of the garcon library.

`major` :	the major version number.
`minor` :	the minor version number.
`micro` :	the micro version number.
Returns :	`TRUE` if the version of the garcon header files is the same as or newer than the passed-in version.

GARCON_MAJOR_VERSION

#define GARCON_MAJOR_VERSION 0

The major version number of the garcon library. Like garcon_major_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

GARCON_MICRO_VERSION

#define GARCON_MICRO_VERSION 1

The micro version number of the garcon library. Like garcon_micro_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

GARCON_MINOR_VERSION

#define GARCON_MINOR_VERSION 2

The minor version number of the garcon library. Like garcon_minor_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

garcon_check_version ()

const gchar *       garcon_check_version                (guint required_major,
                                                         guint required_minor,
                                                         guint required_micro);

Checks that the garcon library in use is compatible with the given version. Generally you would pass in the constants GARCON_MAJOR_VERSION, GARCON_MINOR_VERSION and GARCON_MICRO_VERSION as the three arguments to this function; that produces a check that the library in use is compatible with the version of garcon the application was compiled against.

Example 1. Checking the runtime version of the garcon library

			garcon Reference Manual
Top \| Description