Version Information and Compatibility Checks
Version Information and Compatibility Checks
|
|
Includes
#include <tumbler/tumbler.h>
Functions
TUMBLER_CHECK_VERSION()
#define TUMBLER_CHECK_VERSION(major, minor, micro)
tumbler_check_version ()
const gchar *
tumbler_check_version (guint required_major,
guint required_minor,
guint required_micro);
Checks that the tumbler library
in use is compatible with the given version. Generally you would pass in
the constants TUMBLER_MAJOR_VERSION, TUMBLER_MINOR_VERSION and
TUMBLER_MICRO_VERSION as the three arguments to this function; that
produces a check that the library in use is compatible with the version
of tumbler the application was
compiled against.
Example 1. Checking the runtime version of the tumbler library
1
2
3
4
5
6 |
const gchar *mismatch;
mismatch = tumbler_check_version (TUMBLER_VERSION_MAJOR,
TUMBLER_VERSION_MINOR,
TUMBLER_VERSION_MICRO);
if (G_UNLIKELY (mismatch != NULL))
g_error ("Version mismatch: %s", mismatch); |
Returns
NULL if the library is compatible with the given version,
or a string describing the version mismatch. The returned
string is owned by the library and must not be freed or
modified by the caller.
Types and Values
TUMBLER_MAJOR_VERSION
#define TUMBLER_MAJOR_VERSION 4
TUMBLER_MINOR_VERSION
#define TUMBLER_MINOR_VERSION 20
TUMBLER_MICRO_VERSION
#define TUMBLER_MICRO_VERSION 0
tumbler_major_version
extern const guint tumbler_major_version;
tumbler_minor_version
extern const guint tumbler_minor_version;
tumbler_micro_version
extern const guint tumbler_micro_version;
G_GNUC_NULL_TERMINATED
#define G_GNUC_NULL_TERMINATED __attribute__ ((__sentinel__))
G_GNUC_WARN_UNUSED_RESULT
#define G_GNUC_WARN_UNUSED_RESULT __attribute__ ((warn_unused_result))
