Documentation

No description available in the introspection data.

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 VERSION_MIN_REQUIRED or earlier will cause warnings (but using functions deprecated in later releases will not).

Since: 2.32

No description available in the introspection data.

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

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

Since: 2.16

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

Since: 2.16

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

This is as defined by Unicode 6.1.

Since: 2.32

Evaluates to a time span of one second.

Since: 2.26

Evaluates to a time span of one minute.

Since: 2.26

Evaluates to a time span of one millisecond.

Since: 2.26

Evaluates to a time span of one hour.

Since: 2.26

Evaluates to a time span of one day.

Since: 2.26

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 testRun 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.

• getHomeDir
• getUserCacheDir
• getSystemConfigDirs
• getUserConfigDir
• getSystemDataDirs
• getUserDataDir
• getUserStateDir
• getUserRuntimeDir

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

Since: 2.60

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

The standard delimiters, used in strdelimit.

No description available in the introspection data.

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

Since: 2.32

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

Since: 2.32

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

Evaluates to the initial reference count for grefcount.

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

C code

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",
};

Since: 2.78

Use this for very low priority background tasks.

It is not used within GLib or GTK.

Use this for high priority idle functions.

GTK uses PRIORITY_HIGH_IDLE + 10 for resizing operations, and 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.)

Use this for high priority event sources.

It is not used within GLib or GTK.

Use this for default priority idle functions.

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

Use this for default priority event sources.

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

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

No description available in the introspection data.

No description available in the introspection data.

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

Since: 2.50

No description available in the introspection data.

No description available in the introspection data.

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 OptionArgCallback, OptionArgStringArray or OptionArgFilenameArray.

Using 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.

Since: 2.6

No description available in the introspection data.

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.

The minimum value which can be held in a gint8.

Since: 2.4

The minimum value which can be held in a gint64.

The minimum value which can be held in a gint32.

Since: 2.4

The minimum value which can be held in a gint16.

Since: 2.4

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.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

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.

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

GLib log levels that are considered fatal by default.

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

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 Nothing (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 Nothing (or "") domain. However, defining the domain offers the same advantages as above.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

A key under 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.

Since: 2.14

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

Usually KEY_FILE_DESKTOP_TYPE_APPLICATION, KEY_FILE_DESKTOP_TYPE_LINK, or KEY_FILE_DESKTOP_TYPE_DIRECTORY.

Since: 2.14

A key under 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.

Since: 2.14

A key under 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.

Since: 2.14

A key under 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.

Since: 2.14

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

Since: 2.14

A key under 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.

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

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

Since: 2.14

A key under 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.

Since: 2.14

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

Since: 2.38

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

Since: 2.14

A key under 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.

Since: 2.14

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

Since: 2.38

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.

Since: 2.14

No description available in the introspection data.

No description available in the introspection data.

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

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

Expands to "" on all modern compilers, and to PRETTY_FUNCTION on gcc version 2.x. Don't use it.

Expands to "" on all modern compilers, and to FUNCTION on gcc version 2.x. Don't use it.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

Represents an invalid year.

Represents an invalid Julian day number.

Represents an invalid GDateDay.

A bitmask that restricts the possible flags passed to datalistSetFlags. Passing a flags value where flags & ~G_DATALIST_FLAGS_MASK != 0 is an error.

No description available in the introspection data.

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

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

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

No description available in the introspection data.

No description available in the introspection data.

Evaluates to the initial reference count for gatomicrefcount.

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

C code

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",
};

Since: 2.78

A good size for a buffer to be passed into asciiDtostr. 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:

C code

char buf[G_ASCII_DTOSTR_BUF_SIZE];

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

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.

No description available in the introspection data.