Glib

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

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

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

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

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

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

Represents an invalid #GDateDay.

Represents an invalid Julian day number.

Represents an invalid year.

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

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

The base of natural logarithms.

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.

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.

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

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 %G_GINT16_MODIFIER.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

The natural logarithm of 10.

The natural logarithm of 2.

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

Defines the log domain. See #log-domains.

GLib log levels that are considered fatal by default.

Log levels below 1<

The major version number of the GLib library.

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

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

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

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

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

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

The micro version number of the GLib library.

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

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

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

The minor version number of the GLib library.

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 %G_OPTION_ARG_CALLBACK, %G_OPTION_ARG_STRING_ARRAY or %G_OPTION_ARG_FILENAME_ARRAY.

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

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

Pi divided by 2.

Pi divided by 4.

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

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

Use this for default priority event sources.

Use this for default priority idle functions.

Use this for high priority event sources.

Use this for high priority idle functions.

Use this for very low priority background tasks.

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

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

Use this macro as the return value of a #GSourceFunc to leave the #GSource in the main loop.

Use this macro as the return value of a #GSourceFunc to remove the #GSource from the main loop.

The square root of two.

The standard delimiters, used in g_strdelimit().

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

Evaluates to a time span of one day.

Evaluates to a time span of one hour.

Evaluates to a time span of one millisecond.

Evaluates to a time span of one minute.

Evaluates to a time span of one second.

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

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

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

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

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

A wrapper for the POSIX access() function. This function is used to test a pathname for one or several of read, write or execute permissions, or just existence.

Gets the name of the file without any leading directory components. It returns a pointer into the given file name string.

Find the position of the first bit set in @mask, searching from (but not including) @nth_bit upwards. Bits are numbered from 0 (least significant) to sizeof(#gulong) * 8 - 1 (31 or 63, usually). To start searching from the 0th bit, set @nth_bit to -1.

Find the position of the first bit set in @mask, searching from (but not including) @nth_bit downwards. Bits are numbered from 0 (least significant) to sizeof(#gulong) * 8 - 1 (31 or 63, usually). To start searching from the last bit, set @nth_bit to -1 or GLIB_SIZEOF_LONG * 8.

Gets the number of bits used to hold @number, e.g. if @number is 4, 3 bits are needed.

Behaves exactly like g_build_filename(), but takes the path elements as a string array, instead of varargs. This function is mainly meant for language bindings.

Behaves exactly like g_build_path(), but takes the path elements as a string array, instead of varargs. This function is mainly meant for language bindings.

Gets the canonical file name from @filename. All triple slashes are turned into single slashes, and all .. and .s resolved against @relative_to.

A wrapper for the POSIX chdir() function. The function changes the current directory of the process to @path.

Gets the length in bytes of digests of type @checksum_type

Checks that the GLib library in use is compatible with the given version.

If @err or *@err is null, does nothing. Otherwise, calls g_error_free() on *@err and sets *@err to null.

This wraps the close() call; in case of error, %errno will be preserved, but the error will also be stored as a #GError in @error.

Computes the checksum for a binary @data. This is a convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free().

Computes the checksum of a string.

Computes the HMAC for a binary @data. This is a convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref().

Returns true if the Julian day is valid. Anything greater than zero is basically a valid Julian, though there is a 32-bit limit.

Returns true if the month value is valid. The 12 #GDateMonth enumeration values are the only valid months.

Returns true if the weekday is valid. The seven #GDateWeekday enumeration values are the only valid weekdays.

This is a variant of g_dgettext() that allows specifying a locale category instead of always using LC_MESSAGES. See g_dgettext() for more information about how this functions differs from calling dcgettext() directly.

This function is a wrapper of dgettext() which does not translate the message if the default domain as set with textdomain() has no translations for the current locale.

Creates a subdirectory in the preferred directory for temporary files (as returned by g_get_tmp_dir()).

This function is a wrapper of dngettext() which does not translate the message if the default domain as set with textdomain() has no translations for the current locale.

This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the '\004' character to separate the message context and message id in @msgctxtid. If 0 is passed as @msgidoffset, this function will fall back to trying to use the deprecated convention of using "|" as a separation character.

This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the '\004' character to separate the message context and message id in @msgctxtid.

Returns the value of the environment variable @variable in the provided list @envp.

Sets the environment variable @variable in the provided list

Removes the environment variable @variable from the provided environment @envp.

Gets a #GFileError constant based on the passed-in @err_no.

Returns the display basename for the particular filename, guaranteed to be valid UTF-8. The display name might not be identical to the filename, for instance there might be problems converting it to UTF-8, and some files can be translated in the display.

Converts a filename into a valid UTF-8 string. The conversion is not necessarily reversible, so you should keep the original around and use the return value of this function only for display purposes. Unlike g_filename_to_utf8(), the result is guaranteed to be non-null even if the filename actually isn't in the GLib file name encoding.

Converts an absolute filename to an escaped ASCII-encoded URI, with the path component following Section 3.3. of RFC 2396.

Reads the contents of the symbolic link @filename like the POSIX readlink() function. The returned string is in the encoding used for filenames. Use g_filename_to_utf8() to convert it to UTF-8.

Returns true if any of the tests in the bitfield @test are true. For example, (G_FILE_TEST_EXISTS | G_FILE_TEST_IS_DIR) will return true if the file exists; the check whether it's a directory doesn't matter since the existence test is true. With the current set of available tests, there's no point passing in more than one test at a time.

Locates the first executable named @program in the user's path, in the same way that execvp() would locate it. Returns an allocated string with the absolute path name, or null if the program is not found in the path. If @program is already an absolute path, returns a copy of

Formats a size (for example the size of a file) into a human readable string. Sizes are rounded to the nearest size prefix (kB, MB, GB) and are displayed rounded to the nearest tenth. E.g. the file size 3292528 bytes will be converted into the string "3.2 MB". The returned string is UTF-8, and may use a non-breaking space to separate the number and units, to ensure they aren’t separated when line wrapped.

Formats a size (for example the size of a file) into a human readable string. Sizes are rounded to the nearest size prefix (KB, MB, GB) and are displayed rounded to the nearest tenth. E.g. the file size 3292528 bytes will be converted into the string "3.1 MB".

Formats a size.

Gets a human-readable name for the application, as set by g_set_application_name(). This name should be localized if possible, and is intended for display to the user. Contrast with g_get_prgname(), which gets a non-localized name. If g_set_application_name() has not been called, returns the result of g_get_prgname() (which may be null if g_set_prgname() has also not been called).

Gets the character set for the current locale.

Gets the current directory.

Equivalent to the UNIX gettimeofday() function, but portable.

Returns the value of an environment variable.

Gets the list of environment variables for the current process.

Gets the current user's home directory.

Return a name for the machine.

Computes a list of applicable locale names, which can be used to e.g. construct locale-dependent filenames or search paths. The returned list is sorted from most desirable to least desirable and always contains the default locale "C".

Computes a list of applicable locale names with a locale category name, which can be used to construct the fallback locale-dependent filenames or search paths. The returned list is sorted from most desirable to least desirable and always contains the default locale "C".

Returns a list of derived variants of @locale, which can be used to e.g. construct locale-dependent filenames or search paths. The returned list is sorted from most desirable to least desirable. This function handles territory, charset and extra locale modifiers. See man:setlocale for information about locales and their format.

Queries the system monotonic time.

Determine the approximate number of threads that the system will schedule simultaneously for this process. This is intended to be used as a parameter to g_thread_pool_new() for CPU bound tasks and similar cases.

Get information about the operating system.

Gets the name of the program. This name should not be localized, in contrast to g_get_application_name().

Gets the real name of the user. This usually comes from the user's entry in the passwd file. The encoding of the returned string is system-defined. (On Windows, it is, however, always UTF-8.) If the real user name cannot be determined, the string "Unknown" is returned.

Queries the system wall-clock time.

Returns an ordered list of base directories in which to access system-wide configuration information.

Returns an ordered list of base directories in which to access system-wide application data.

Gets the directory to use for temporary files.

Returns a base directory in which to store non-essential, cached data specific to particular user.

Returns a base directory in which to store user-specific application configuration information such as user preferences and settings.

Returns a base directory in which to access application data such as icons that is customized for a particular user.

Gets the user name of the current user. The encoding of the returned string is system-defined. On UNIX, it might be the preferred file name encoding, or something else, and there is no guarantee that it is even consistent on a machine. On Windows, it is always UTF-8.

Returns a directory that is unique to the current user on the local system.

Returns the full path of a special directory using its logical id.

Returns a base directory in which to store state files specific to particular user.

Destroys all keys and values in the #GHashTable and decrements its reference count by 1. If keys and/or values are dynamically allocated, you should either free them first or create the #GHashTable with destroy notifiers using g_hash_table_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values during the destruction phase.

Creates a new #GHashTable like g_hash_table_new_full() with a reference count of 1.

Removes all keys and their associated values from a #GHashTable.

Returns the number of elements contained in the #GHashTable.

Removes all keys and their associated values from a #GHashTable without calling the key and value destroy functions.

Atomically decrements the reference count of @hash_table by one. If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread.

Destroys a #GHook, given its ID.

Removes one #GHook from a #GHookList, marking it inactive and calling g_hook_unref() on it.

Calls the #GHookList @finalize_hook function if it exists, and frees the memory allocated for the #GHook.

Inserts a #GHook into a #GHookList, before a given #GHook.

Prepends a #GHook on the start of a #GHookList.

Decrements the reference count of a #GHook. If the reference count falls to 0, the #GHook is removed from the #GHookList and g_hook_free() is called to free it.

Tests if @hostname contains segments with an ASCII-compatible encoding of an Internationalized Domain Name. If this returns true, you should decode the hostname with g_hostname_to_unicode() before displaying it to the user.

Tests if @hostname is the string form of an IPv4 or IPv6 address. (Eg, "192.168.0.1".)

Tests if @hostname contains Unicode characters. If this returns true, you need to encode the hostname with g_hostname_to_ascii() before using it in non-IDN-aware contexts.

Converts @hostname to its canonical ASCII form; an ASCII-only string containing no uppercase letters and not ending with a trailing dot.

Converts @hostname to its canonical presentation form; a UTF-8 string in Unicode normalization form C, containing no uppercase letters, no forbidden characters, and no ASCII-encoded segments, and not ending with a trailing dot.

Adds a function to be called whenever there are no higher priority events pending.

Creates a new idle source.

Returns a canonical representation for @string. Interned strings can be compared for equality by comparing the pointers, instead of using strcmp(). g_intern_static_string() does not copy the string, therefore @string must not be freed or modified.

Returns a canonical representation for @string. Interned strings can be compared for equality by comparing the pointers, instead of using strcmp().