Version information

Version information — Variables and functions to check the library version

Stability Level

Stable, unless otherwise indicated

Synopsis

#include <thunarx/thunarx.h>

extern const guint  thunarx_major_version;
extern const guint  thunarx_minor_version;
extern const guint  thunarx_micro_version;
const gchar *       thunarx_check_version               (guint required_major,
                                                         guint required_minor,
                                                         guint required_micro);
#define             THUNARX_MAJOR_VERSION
#define             THUNARX_MINOR_VERSION
#define             THUNARX_MICRO_VERSION
#define             THUNARX_CHECK_VERSION               (major,
                                                         minor,
                                                         micro)

Description

The Thunar Extension library provides version information, which should be used by extensions.

Details

thunarx_major_version

extern const guint thunarx_major_version;

The major version number of the thunarx library (e.g. in version 0.5.1 this is 0).

This variable is in the library, so represents the thunarx library you have linked against. Contrast with the THUNARX_MAJOR_VERSION macro, which represents the major version of the thunarx headers you have included.


thunarx_minor_version

extern const guint thunarx_minor_version;

The minor version number of the thunarx library (e.g. in version 0.5.1 this is 5).

This variable is in the library, so represents the thunarx library you have linked against. Contrast with the THUNARX_MINOR_VERSION macro, which represents the minor version of the thunarx headers you have included.


thunarx_micro_version

extern const guint thunarx_micro_version;

The micro version number of the thunarx library (e.g. in version 0.5.1 this is 1).

This variable is in the library, so represents the thunarx library you have linked against. Contrast with the THUNARX_MICRO_VERSION macro, which represents the micro version of the thunarx headers you have included.


thunarx_check_version ()

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

Checks that the thunarx library in use is compatible with the given version. Generally you would pass in the constants THUNARX_MAJOR_VERSION, THUNARX_MINOR_VERSION and THUNARX_VERSION_MICRO as the three arguments to this function; that produces a check that the library in use is compatible with the version of thunarx the extension was compiled against.

This function should be called by extensions in the thunar_extension_initialize() method to verify that the thunarx library used by file manager is compatible with the version the extension was compiled with.

Example 3. Checking the runtime version of the Thunar Extension library

1
2
3
4
5
6
7
8
9