Constants

Details

GLib.ANALYZER_ANALYZING = 1
GLib.ASCII_DTOSTR_BUF_SIZE = 39

A good size for a buffer to be passed into GLib.ascii_dtostr(). It is guaranteed to be enough for all output of that function on systems with 64bit IEEE-compatible doubles.

The typical usage would be something like:

char buf[G_ASCII_DTOSTR_BUF_SIZE];

fprintf (out, "value=%s\n", g_ascii_dtostr (buf, sizeof (buf), value));
GLib.ATOMIC_REF_COUNT_INIT = 1

Evaluates to the initial reference count for gatomicrefcount.

This macro is useful for initializing gatomicrefcount fields inside structures, for instance:

typedef struct {
  gatomicrefcount ref_count;
  char *name;
  char *address;
} Person;

static const Person default_person = {
  .ref_count = G_ATOMIC_REF_COUNT_INIT,
  .name = "Default name",
  .address = "Default address",
};

New in version 2.78.

GLib.BIG_ENDIAN = 4321

Specifies one of the possible types of byte order. See %G_BYTE_ORDER.

GLib.CSET_A_2_Z = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'

The set of uppercase ASCII alphabet characters. Used for specifying valid identifier characters in GLib.ScannerConfig.

GLib.CSET_DIGITS = '0123456789'

The set of ASCII digits. Used for specifying valid identifier characters in GLib.ScannerConfig.

GLib.CSET_a_2_z = 'abcdefghijklmnopqrstuvwxyz'

The set of lowercase ASCII alphabet characters. Used for specifying valid identifier characters in GLib.ScannerConfig.

GLib.C_STD_VERSION = 199000

The C standard version the code is compiling against, it’s normally defined with the same value of __STDC_VERSION__ for C standard compatible compilers, while it uses the lowest standard version in pure MSVC, given that in such compiler the definition depends on a compilation flag.

This is granted to be undefined when compiling with a C++ compiler.

See also: %G_C_STD_CHECK_VERSION and %G_CXX_STD_VERSION

New in version 2.76.

GLib.DATALIST_FLAGS_MASK = 3

A bitmask that restricts the possible flags passed to GLib.datalist_set_flags(). Passing a flags value where flags & ~:obj:GLib.DATALIST_FLAGS_MASK != 0 is an error.

GLib.DATE_BAD_DAY = 0

Represents an invalid #GDateDay.

GLib.DATE_BAD_JULIAN = 0

Represents an invalid Julian day number.

GLib.DATE_BAD_YEAR = 0

Represents an invalid year.

GLib.DIR_SEPARATOR = 47

The directory separator character. This is ‘/’ on UNIX machines and ‘\’ under Windows.

GLib.DIR_SEPARATOR_S = '/'

The directory separator as a string. This is “/” on UNIX machines and “\” under Windows.

GLib.E = 2.718282

The base of natural logarithms.

GLib.GINT16_FORMAT = 'hi'

This is the platform dependent conversion specifier for scanning and printing values of type #gint16. It is a string literal, but doesn’t include the percent-sign, such that you can add precision and length modifiers between percent-sign and conversion specifier.

gint16 in;
gint32 out;
sscanf ("42", "%" G_GINT16_FORMAT, &in)
out = in * 1000;
g_print ("%" G_GINT32_FORMAT, out);

This is not necessarily the correct format for printing and scanning
`int16_t` values, even though the in-memory representation is the same.
Standard C macros like `PRId16` and `SCNd16` should be used for `int16_t`.
GLib.GINT16_MODIFIER = 'h'

The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gint16 or #guint16. It is a string literal, but doesn’t include the percent-sign, such that you can add precision and length modifiers between percent-sign and conversion specifier and append a conversion specifier.

The following example prints “0x7b”;

gint16 value = 123;
g_print ("%#" G_GINT16_MODIFIER "x", value);

This is not necessarily the correct modifier for printing and scanning int16_t values, even though the in-memory representation is the same. Standard C macros like PRId16 and SCNd16 should be used for int16_t.

New in version 2.4.

GLib.GINT32_FORMAT = 'i'

This is the platform dependent conversion specifier for scanning and printing values of type #gint32. See also GLib.GINT16_FORMAT.

This is not necessarily the correct modifier for printing and scanning int32_t values, even though the in-memory representation is the same. Standard C macros like PRId32 and SCNd32 should be used for int32_t.

GLib.GINT32_MODIFIER = ''

The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gint32 or #guint32. It is a string literal. See also GLib.GINT16_MODIFIER.

This is not necessarily the correct modifier for printing and scanning int32_t values, even though the in-memory representation is the same. Standard C macros like PRId32 and SCNd32 should be used for int32_t.

New in version 2.4.

GLib.GINT64_FORMAT = 'li'

This is the platform dependent conversion specifier for scanning and printing values of type #gint64. See also GLib.GINT16_FORMAT.

Some platforms do not support scanning and printing 64-bit integers, even though the types are supported. On such platforms GLib.GINT64_FORMAT is not defined. Note that scanf() may not support 64-bit integers, even if GLib.GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not recommended for parsing anyway; consider using GLib.ascii_strtoull() instead.

This is not necessarily the correct format for printing and scanning int64_t values, even though the in-memory representation is the same. Standard C macros like PRId64 and SCNd64 should be used for int64_t.

GLib.GINT64_MODIFIER = 'l'

The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gint64 or #guint64. It is a string literal.

Some platforms do not support printing 64-bit integers, even though the types are supported. On such platforms GLib.GINT64_MODIFIER is not defined.

This is not necessarily the correct modifier for printing and scanning int64_t values, even though the in-memory representation is the same. Standard C macros like PRId64 and SCNd64 should be used for int64_t.

New in version 2.4.

GLib.GINTPTR_FORMAT = 'li'

This is the platform dependent conversion specifier for scanning and printing values of type #gintptr.

Note that this is not necessarily the correct format to scan or print an intptr_t, even though the in-memory representation is the same. Standard C macros like PRIdPTR and SCNdPTR should be used for intptr_t.

New in version 2.22.

GLib.GINTPTR_MODIFIER = 'l'

The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gintptr or #guintptr. It is a string literal.

Note that this is not necessarily the correct modifier to scan or print an intptr_t, even though the in-memory representation is the same. Standard C macros like PRIdPTR and SCNdPTR should be used for intptr_t.

New in version 2.22.

GLib.GNUC_FUNCTION = ''

Expands to “” on all modern compilers, and to __FUNCTION__ on gcc version 2.x. Don’t use it.

Deprecated since version 2.16: Use G_STRFUNC() instead

GLib.GNUC_PRETTY_FUNCTION = ''

Expands to “” on all modern compilers, and to __PRETTY_FUNCTION__ on gcc version 2.x. Don’t use it.

Deprecated since version 2.16: Use G_STRFUNC() instead

GLib.GSIZE_FORMAT = 'lu'

This is the platform dependent conversion specifier for scanning and printing values of type #gsize. See also GLib.GINT16_FORMAT.

Note that this is not necessarily the correct format to scan or print a size_t, even though the in-memory representation is the same. The standard C "zu" format should be used for size_t, assuming a C99-compliant printf implementation is available.

New in version 2.6.

GLib.GSIZE_MODIFIER = 'l'

The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gsize. It is a string literal.

Note that this is not necessarily the correct modifier to scan or print a size_t, even though the in-memory representation is the same. The Standard C "z" modifier should be used for size_t, assuming a C99-compliant printf implementation is available.

New in version 2.6.

GLib.GSSIZE_FORMAT = 'li'

This is the platform dependent conversion specifier for scanning and printing values of type #gssize. See also GLib.GINT16_FORMAT.

Note that this is not necessarily the correct format to scan or print a POSIX ssize_t or a Windows SSIZE_T, even though the in-memory representation is the same. On POSIX platforms, the "zd" format should be used for ssize_t.

New in version 2.6.

GLib.GSSIZE_MODIFIER = 'l'

The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gssize. It is a string literal.

Note that this is not necessarily the correct modifier to scan or print a POSIX ssize_t or a Windows SSIZE_T, even though the in-memory representation is the same. On POSIX platforms, the "z" modifier should be used for ssize_t.

New in version 2.6.

GLib.GUINT16_FORMAT = 'hu'

This is the platform dependent conversion specifier for scanning and printing values of type #guint16. See also GLib.GINT16_FORMAT

This is not necessarily the correct modifier for printing and scanning uint16_t values, even though the in-memory representation is the same. Standard C macros like PRIu16 and SCNu16 should be used for uint16_t.

GLib.GUINT32_FORMAT = 'u'

This is the platform dependent conversion specifier for scanning and printing values of type #guint32. See also GLib.GINT16_FORMAT.

This is not necessarily the correct modifier for printing and scanning uint32_t values, even though the in-memory representation is the same. Standard C macros like PRIu32 and SCNu32 should be used for uint32_t.

GLib.GUINT64_FORMAT = 'lu'

This is the platform dependent conversion specifier for scanning and printing values of type #guint64. See also GLib.GINT16_FORMAT.

Some platforms do not support scanning and printing 64-bit integers, even though the types are supported. On such platforms GLib.GUINT64_FORMAT is not defined. Note that scanf() may not support 64-bit integers, even if GLib.GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not recommended for parsing anyway; consider using GLib.ascii_strtoull() instead.

This is not necessarily the correct modifier for printing and scanning uint64_t values, even though the in-memory representation is the same. Standard C macros like PRIu64 and SCNu64 should be used for uint64_t.

GLib.GUINTPTR_FORMAT = 'lu'

This is the platform dependent conversion specifier for scanning and printing values of type #guintptr.

Note that this is not necessarily the correct format to scan or print a uintptr_t, even though the in-memory representation is the same. Standard C macros like PRIuPTR and SCNuPTR should be used for uintptr_t.

New in version 2.22.

GLib.HAVE_GINT64 = 1
GLib.HAVE_GNUC_VARARGS = 1
GLib.HAVE_GNUC_VISIBILITY = 1

Defined to 1 if gcc-style visibility handling is supported.

GLib.HAVE_GROWING_STACK = 0
GLib.HAVE_ISO_VARARGS = 1
GLib.HOOK_FLAG_USER_SHIFT = 4

The position of the first bit which is not reserved for internal use be the GLib.Hook implementation, i.e. 1 << G_HOOK_FLAG_USER_SHIFT is the first bit which can be used for application-defined flags.

GLib.IEEE754_DOUBLE_BIAS = 1023

The bias by which exponents in double-precision floats are offset.

GLib.IEEE754_FLOAT_BIAS = 127

The bias by which exponents in single-precision floats are offset.

GLib.IO_ERR = <flags ERR of type IOCondition>
GLib.IO_FLAG_APPEND = <flags APPEND | MASK | GET_MASK | SET_MASK of type IOFlags>
GLib.IO_FLAG_GET_MASK = <flags APPEND | NONBLOCK | IS_READABLE | IS_WRITABLE | IS_WRITEABLE | IS_SEEKABLE | MASK | GET_MASK | SET_MASK of type IOFlags>
GLib.IO_FLAG_IS_READABLE = <flags IS_READABLE | MASK | GET_MASK of type IOFlags>
GLib.IO_FLAG_IS_SEEKABLE = <flags IS_SEEKABLE | MASK | GET_MASK of type IOFlags>
GLib.IO_FLAG_IS_WRITEABLE = <flags IS_WRITABLE | IS_WRITEABLE | MASK | GET_MASK of type IOFlags>
GLib.IO_FLAG_MASK = <flags APPEND | NONBLOCK | IS_READABLE | IS_WRITABLE | IS_WRITEABLE | IS_SEEKABLE | MASK | GET_MASK | SET_MASK of type IOFlags>
GLib.IO_FLAG_NONBLOCK = <flags NONBLOCK | MASK | GET_MASK | SET_MASK of type IOFlags>
GLib.IO_FLAG_SET_MASK = <flags APPEND | NONBLOCK | MASK | GET_MASK | SET_MASK of type IOFlags>
GLib.IO_HUP = <flags HUP of type IOCondition>
GLib.IO_IN = <flags IN of type IOCondition>
GLib.IO_NVAL = <flags NVAL of type IOCondition>
GLib.IO_OUT = <flags OUT of type IOCondition>
GLib.IO_PRI = <flags PRI of type IOCondition>
GLib.IO_STATUS_AGAIN = <enum AGAIN of type IOStatus>
GLib.IO_STATUS_EOF = <enum EOF of type IOStatus>
GLib.IO_STATUS_ERROR = <enum ERROR of type IOStatus>
GLib.IO_STATUS_NORMAL = <enum NORMAL of type IOStatus>
GLib.KEY_FILE_DESKTOP_GROUP = 'Desktop Entry'

The name of the main group of a desktop entry file, as defined in the Desktop Entry Specification. Consult the specification for more details about the meanings of the keys below.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_ACTIONS = 'Actions'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string list giving the available application actions.

New in version 2.38.

GLib.KEY_FILE_DESKTOP_KEY_CATEGORIES = 'Categories'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the categories in which the desktop entry should be shown in a menu.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_COMMENT = 'Comment'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the tooltip for the desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE = 'DBusActivatable'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true if the application is D-Bus activatable.

New in version 2.38.

GLib.KEY_FILE_DESKTOP_KEY_EXEC = 'Exec'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string giving the command line to execute. It is only valid for desktop entries with the Application type.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_GENERIC_NAME = 'GenericName'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the generic name of the desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_HIDDEN = 'Hidden'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry has been deleted by the user.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_ICON = 'Icon'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the name of the icon to be displayed for the desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_MIME_TYPE = 'MimeType'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the MIME types supported by this desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_NAME = 'Name'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the specific name of the desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN = 'NotShowIn'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should not display the desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_NO_DISPLAY = 'NoDisplay'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry should be shown in menus.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN = 'OnlyShowIn'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should display the desktop entry.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_PATH = 'Path'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string containing the working directory to run the program in. It is only valid for desktop entries with the Application type.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY = 'StartupNotify'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the application supports the Startup Notification Protocol Specification.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS = 'StartupWMClass'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is string identifying the WM class or name hint of a window that the application will create, which can be used to emulate Startup Notification with older applications.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_TERMINAL = 'Terminal'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the program should be run in a terminal window.

It is only valid for desktop entries with the Application type.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_TRY_EXEC = 'TryExec'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string giving the file name of a binary on disk used to determine if the program is actually installed. It is only valid for desktop entries with the Application type.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_TYPE = 'Type'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string giving the type of the desktop entry.

Usually GLib.KEY_FILE_DESKTOP_TYPE_APPLICATION, GLib.KEY_FILE_DESKTOP_TYPE_LINK, or GLib.KEY_FILE_DESKTOP_TYPE_DIRECTORY.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_URL = 'URL'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string giving the URL to access. It is only valid for desktop entries with the Link type.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_KEY_VERSION = 'Version'

A key under GLib.KEY_FILE_DESKTOP_GROUP, whose value is a string giving the version of the Desktop Entry Specification used for the desktop entry file.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_TYPE_APPLICATION = 'Application'

The value of the GLib.KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing applications.

New in version 2.14.

GLib.KEY_FILE_DESKTOP_TYPE_DIRECTORY = 'Directory'

The value of the GLib.KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing directories.

New in version 2.14.

The value of the GLib.KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing links to documents.

New in version 2.14.

GLib.LITTLE_ENDIAN = 1234

Specifies one of the possible types of byte order. See %G_BYTE_ORDER.

GLib.LN10 = 2.302585

The natural logarithm of 10.

GLib.LN2 = 0.693147

The natural logarithm of 2.

GLib.LOG_2_BASE_10 = 0.30103

Multiplying the base 2 exponent by this number yields the base 10 exponent.

GLib.LOG_DOMAIN = 0

Defines the log domain. See Log Domains.

Libraries should define this so that any messages which they log can be differentiated from messages from other libraries and application code. But be careful not to define it in any public header files.

Log domains must be unique, and it is recommended that they are the application or library name, optionally followed by a hyphen and a sub-domain name. For example, bloatpad or bloatpad-io.

If undefined, it defaults to the default None (or "") log domain; this is not advisable, as it cannot be filtered against using the G_MESSAGES_DEBUG environment variable.

For example, GTK uses this in its Makefile.am :

AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\"

Applications can choose to leave it as the default None (or "") domain. However, defining the domain offers the same advantages as above.

GLib.LOG_FATAL_MASK = 5

GLib log levels that are considered fatal by default.

This is not used if structured logging is enabled; see Using Structured Logging.

GLib.LOG_LEVEL_USER_SHIFT = 8

Log levels below 1<<GLib.LOG_LEVEL_USER_SHIFT are used by GLib. Higher bits can be used for user-defined log levels.

GLib.MAJOR_VERSION = 2

The major version number of the GLib library.

Like #glib_major_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

GLib.MAXDOUBLE = 1.7976931348623157e+308
GLib.MAXFLOAT = 3.4028234663852886e+38
GLib.MAXINT = 2147483647
GLib.MAXINT16 = 32767

The maximum value which can be held in a #gint16.

This is the same as standard C INT16_MAX, which should be preferred in new code.

New in version 2.4.

GLib.MAXINT32 = 2147483647

The maximum value which can be held in a #gint32.

This is the same as standard C INT32_MAX, which should be preferred in new code.

New in version 2.4.

GLib.MAXINT64 = 9223372036854775807

The maximum value which can be held in a #gint64.

GLib.MAXINT8 = 127

The maximum value which can be held in a #gint8.

This is the same as standard C INT8_MAX, which should be preferred in new code.

New in version 2.4.

GLib.MAXLONG = 9223372036854775807
GLib.MAXOFFSET = 9223372036854775807
GLib.MAXSHORT = 32767
GLib.MAXSIZE = 18446744073709551615
GLib.MAXSSIZE = 9223372036854775807
GLib.MAXUINT = 4294967295
GLib.MAXUINT16 = 65535

The maximum value which can be held in a #guint16.

This is the same as standard C UINT16_MAX, which should be preferred in new code.

New in version 2.4.

GLib.MAXUINT32 = 4294967295

The maximum value which can be held in a #guint32.

This is the same as standard C UINT32_MAX, which should be preferred in new code.

New in version 2.4.

GLib.MAXUINT64 = 18446744073709551615

The maximum value which can be held in a #guint64.

This is the same as standard C UINT64_MAX, which should be preferred in new code.

GLib.MAXUINT8 = 255

The maximum value which can be held in a #guint8.

This is the same as standard C UINT8_MAX, which should be preferred in new code.

New in version 2.4.

GLib.MAXULONG = 18446744073709551615
GLib.MAXUSHORT = 65535
GLib.MICRO_VERSION = 3

The micro version number of the GLib library.

Like #gtk_micro_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

GLib.MINDOUBLE = 2.2250738585072014e-308
GLib.MINFLOAT = 1.1754943508222875e-38
GLib.MININT = -2147483648
GLib.MININT16 = -32768

The minimum value which can be held in a #gint16.

New in version 2.4.

GLib.MININT32 = -2147483648

The minimum value which can be held in a #gint32.

New in version 2.4.

GLib.MININT64 = -9223372036854775808

The minimum value which can be held in a #gint64.

GLib.MININT8 = -128

The minimum value which can be held in a #gint8.

New in version 2.4.

GLib.MINLONG = -9223372036854775808
GLib.MINOFFSET = -9223372036854775808
GLib.MINOR_VERSION = 78

The minor version number of the GLib library.

Like #gtk_minor_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

GLib.MINSHORT = -32768
GLib.MINSSIZE = -9223372036854775808
GLib.MODULE_SUFFIX = 'so'
GLib.OPTION_ERROR_BAD_VALUE = <enum BAD_VALUE of type OptionError>
GLib.OPTION_ERROR_FAILED = <enum FAILED of type OptionError>
GLib.OPTION_ERROR_UNKNOWN_OPTION = <enum UNKNOWN_OPTION of type OptionError>
GLib.OPTION_FLAG_FILENAME = <flags FILENAME of type OptionFlags>
GLib.OPTION_FLAG_HIDDEN = <flags HIDDEN of type OptionFlags>
GLib.OPTION_FLAG_IN_MAIN = <flags IN_MAIN of type OptionFlags>
GLib.OPTION_FLAG_NOALIAS = <flags NOALIAS of type OptionFlags>
GLib.OPTION_FLAG_NO_ARG = <flags NO_ARG of type OptionFlags>
GLib.OPTION_FLAG_OPTIONAL_ARG = <flags OPTIONAL_ARG of type OptionFlags>
GLib.OPTION_FLAG_REVERSE = <flags REVERSE of type OptionFlags>
GLib.OPTION_REMAINING = ''

If a long option in the main group has this name, it is not treated as a regular option. Instead it collects all non-option arguments which would otherwise be left in argv. The option must be of type GLib.OptionArg.CALLBACK, GLib.OptionArg.STRING_ARRAY or GLib.OptionArg.FILENAME_ARRAY.

Using GLib.OPTION_REMAINING instead of simply scanning argv for leftover arguments has the advantage that GOption takes care of necessary encoding conversions for strings or filenames.

New in version 2.6.

GLib.PDP_ENDIAN = 3412

Specifies one of the possible types of byte order (currently unused). See %G_BYTE_ORDER.

GLib.PI = 3.141593

The value of pi (ratio of circle’s circumference to its diameter).

GLib.PID_FORMAT = 'i'

A format specifier that can be used in printf()-style format strings when printing a #GPid.

New in version 2.50.

GLib.PI_2 = 1.570796

Pi divided by 2.

GLib.PI_4 = 0.785398

Pi divided by 4.

GLib.POLLFD_FORMAT = '%d'

A format specifier that can be used in printf()-style format strings when printing the fd member of a GLib.PollFD.

GLib.PRIORITY_DEFAULT = 0

Use this for default priority event sources.

In GLib this priority is used when adding timeout functions with GLib.timeout_add(). In GDK this priority is used for events from the X server.

GLib.PRIORITY_DEFAULT_IDLE = 200

Use this for default priority idle functions.

In GLib this priority is used when adding idle functions with GLib.idle_add().

GLib.PRIORITY_HIGH = -100

Use this for high priority event sources.

It is not used within GLib or GTK.

GLib.PRIORITY_HIGH_IDLE = 100

Use this for high priority idle functions.

GTK uses GLib.PRIORITY_HIGH_IDLE + 10 for resizing operations, and GLib.PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is done to ensure that any pending resizes are processed before any pending redraws, so that widgets are not redrawn twice unnecessarily.)

GLib.PRIORITY_LOW = 300

Use this for very low priority background tasks.

It is not used within GLib or GTK.

GLib.REF_COUNT_INIT = -1

Evaluates to the initial reference count for grefcount.

This macro is useful for initializing grefcount fields inside structures, for instance:

typedef struct {
  grefcount ref_count;
  char *name;
  char *address;
} Person;

static const Person default_person = {
  .ref_count = G_REF_COUNT_INIT,
  .name = "Default name",
  .address = "Default address",
};

New in version 2.78.

GLib.SEARCHPATH_SEPARATOR = 58

The search path separator character. This is ‘:’ on UNIX machines and ‘;’ under Windows.

GLib.SEARCHPATH_SEPARATOR_S = ':'

The search path separator as a string. This is “:” on UNIX machines and “;” under Windows.

GLib.SIZEOF_LONG = 8
GLib.SIZEOF_SIZE_T = 8
GLib.SIZEOF_SSIZE_T = 8
GLib.SIZEOF_VOID_P = 8
GLib.SOURCE_CONTINUE = 1

Use this macro as the return value of a GLib.SourceFunc to leave the GLib.Source in the main loop.

New in version 2.32.

GLib.SOURCE_REMOVE = 0

Use this macro as the return value of a GLib.SourceFunc to remove the GLib.Source from the main loop.

New in version 2.32.

GLib.SPAWN_CHILD_INHERITS_STDIN = <flags CHILD_INHERITS_STDIN of type SpawnFlags>
GLib.SPAWN_DO_NOT_REAP_CHILD = <flags DO_NOT_REAP_CHILD of type SpawnFlags>
GLib.SPAWN_FILE_AND_ARGV_ZERO = <flags FILE_AND_ARGV_ZERO of type SpawnFlags>
GLib.SPAWN_LEAVE_DESCRIPTORS_OPEN = <flags LEAVE_DESCRIPTORS_OPEN of type SpawnFlags>
GLib.SPAWN_SEARCH_PATH = <flags SEARCH_PATH of type SpawnFlags>
GLib.SPAWN_STDERR_TO_DEV_NULL = <flags STDERR_TO_DEV_NULL of type SpawnFlags>
GLib.SPAWN_STDOUT_TO_DEV_NULL = <flags STDOUT_TO_DEV_NULL of type SpawnFlags>
GLib.SQRT2 = 1.414214

The square root of two.

GLib.STR_DELIMITERS = '_-|> <.'

The standard delimiters, used in GLib.strdelimit().

GLib.SYSDEF_AF_INET = 2
GLib.SYSDEF_AF_INET6 = 10
GLib.SYSDEF_AF_UNIX = 1
GLib.SYSDEF_MSG_DONTROUTE = 4
GLib.SYSDEF_MSG_OOB = 1
GLib.SYSDEF_MSG_PEEK = 2
GLib.TEST_OPTION_ISOLATE_DIRS = 'isolate_dirs'

Creates a unique temporary directory for each unit test and uses g_set_user_dirs() to set XDG directories to point into subdirectories of it for the duration of the unit test. The directory tree is cleaned up after the test finishes successfully. Note that this doesn’t take effect until GLib.test_run() is called, so calls to (for example) g_get_user_home_dir() will return the system-wide value when made in a test program’s main() function.

The following functions will return subdirectories of the temporary directory when this option is used. The specific subdirectory paths in use are not guaranteed to be stable API — always use a getter function to retrieve them.

The subdirectories may not be created by the test harness; as with normal calls to functions like GLib.get_user_cache_dir(), the caller must be prepared to create the directory if it doesn’t exist.

New in version 2.60.

GLib.TIME_SPAN_DAY = 86400000000

Evaluates to a time span of one day.

New in version 2.26.

GLib.TIME_SPAN_HOUR = 3600000000

Evaluates to a time span of one hour.

New in version 2.26.

GLib.TIME_SPAN_MILLISECOND = 1000

Evaluates to a time span of one millisecond.

New in version 2.26.

GLib.TIME_SPAN_MINUTE = 60000000

Evaluates to a time span of one minute.

New in version 2.26.

GLib.TIME_SPAN_SECOND = 1000000

Evaluates to a time span of one second.

New in version 2.26.

GLib.UNICHAR_MAX_DECOMPOSITION_LENGTH = 18

The maximum length (in codepoints) of a compatibility or canonical decomposition of a single Unicode character.

This is as defined by Unicode 6.1.

New in version 2.32.

GLib.URI_RESERVED_CHARS_GENERIC_DELIMITERS = ':/?#[]@'

Generic delimiters characters as defined in RFC 3986. Includes :/?#[]@.

New in version 2.16.

GLib.URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS = "!$&'()*+,;="

Subcomponent delimiter characters as defined in RFC 3986. Includes !$&'()*+,;=.

New in version 2.16.

GLib.USEC_PER_SEC = 1000000

Number of microseconds in one second (1 million). This macro is provided for code readability.

GLib.USER_DIRECTORY_DESKTOP = <enum DIRECTORY_DESKTOP of type UserDirectory>
GLib.USER_DIRECTORY_DOCUMENTS = <enum DIRECTORY_DOCUMENTS of type UserDirectory>
GLib.USER_DIRECTORY_DOWNLOAD = <enum DIRECTORY_DOWNLOAD of type UserDirectory>
GLib.USER_DIRECTORY_MUSIC = <enum DIRECTORY_MUSIC of type UserDirectory>
GLib.USER_DIRECTORY_PICTURES = <enum DIRECTORY_PICTURES of type UserDirectory>
GLib.USER_DIRECTORY_PUBLIC_SHARE = <enum DIRECTORY_PUBLIC_SHARE of type UserDirectory>
GLib.USER_DIRECTORY_TEMPLATES = <enum DIRECTORY_TEMPLATES of type UserDirectory>
GLib.USER_DIRECTORY_VIDEOS = <enum DIRECTORY_VIDEOS of type UserDirectory>
GLib.VA_COPY_AS_ARRAY = 1
GLib.VERSION_MIN_REQUIRED = 2

A macro that should be defined by the user prior to including the glib.h header. The definition should be one of the predefined GLib version macros: %GLIB_VERSION_2_26, %GLIB_VERSION_2_28,…

This macro defines the earliest version of GLib that the package is required to be able to compile against.

If the compiler is configured to warn about the use of deprecated functions, then using functions that were deprecated in version GLib.VERSION_MIN_REQUIRED or earlier will cause warnings (but using functions deprecated in later releases will not).

New in version 2.32.

GLib.WIN32_MSG_HANDLE = 19981206
GLib.glib_version = (2, 78, 3)
GLib.macro__has_attribute___noreturn__ = 0
GLib.pyglib_version = (0, 0, 12)