| 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.
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 36
The minor component of the version of Pango available at compile-time.
#define PANGO_VERSION_MICRO 8
The micro component of the version of Pango available at compile-time.