Top |
#define | PANGO_VERSION_ENCODE() |
#define | PANGO_VERSION_CHECK() |
int | pango_version () |
const char * | pango_version_string () |
const char * | pango_version_check () |
#define | PANGO_VERSION |
#define | PANGO_VERSION_MAJOR |
#define | PANGO_VERSION_MINOR |
#define | PANGO_VERSION_MICRO |
#define | PANGO_VERSION_STRING |
The capital-letter macros defined here can be used to check the version of Pango at compile-time, and to encode Pango versions into integers.
The functions can be used to check the version of the linked Pango library at run-time.
#define PANGO_VERSION_ENCODE(major, minor, micro)
This macro encodes the given Pango version into an integer. The numbers
returned by PANGO_VERSION
and pango_version()
are encoded using this macro.
Two encoded version numbers can be compared as integers.
#define PANGO_VERSION_CHECK(major,minor,micro)
Checks that the version of Pango available at compile-time is not older than the provided version number.
int
pango_version (void
);
This is similar to the macro PANGO_VERSION
except that
it returns the encoded version of Pango available at run-time,
as opposed to the version available at compile-time.
A version number can be encoded into an integer using
PANGO_VERSION_ENCODE()
.
Since: 1.16
const char *
pango_version_string (void
);
This is similar to the macro PANGO_VERSION_STRING
except that
it returns the version of Pango available at run-time, as opposed to
the version available at compile-time.
A string containing the version of Pango library available at run time. The returned string is owned by Pango and should not be modified or freed.
Since: 1.16
const char * pango_version_check (int required_major
,int required_minor
,int required_micro
);
Checks that the Pango library in use is compatible with the
given version. Generally you would pass in the constants
PANGO_VERSION_MAJOR
, PANGO_VERSION_MINOR
, PANGO_VERSION_MICRO
as the three arguments to this function; that produces
a check that the library in use at run-time is compatible with
the version of Pango the application or module was compiled against.
Compatibility is defined by two things: first the version
of the running library is newer than the version
required_major.required_minor
.required_micro
. Second
the running library must be binary compatible with the
version required_major.required_minor
.required_micro
(same major version.)
For compile-time version checking use PANGO_VERSION_CHECK()
.
required_major |
the required major version. |
|
required_minor |
the required minor version. |
|
required_micro |
the required major version. |
NULL
if the Pango library is compatible
with the given version, or a string describing the version
mismatch. The returned string is owned by Pango and should not
be modified or freed.
[nullable]
Since: 1.16
#define PANGO_VERSION
The version of Pango available at compile-time, encoded using PANGO_VERSION_ENCODE()
.
#define PANGO_VERSION_MAJOR 1
The major component of the version of Pango available at compile-time.
#define PANGO_VERSION_MINOR 37
The minor component of the version of Pango available at compile-time.
#define PANGO_VERSION_MICRO 2
The micro component of the version of Pango available at compile-time.