GLib

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

Evaluates to the initial reference count for gatomicrefcount.

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

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.

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.

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.

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<<G_LOG_LEVEL_USER_SHIFT are used by GLib. Higher bits can be used for user-defined log levels.

The major version number of the GLib library.

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 minimum value which can be held in a #gint8.

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.

Evaluates to the initial reference count for grefcount.

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 callback@GLib.SourceFunc to leave the struct@GLib.Source in the main loop.

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

The square root of two.

The standard delimiters, used in func@GLib.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.

This function is similar to g_malloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to align the allocated memory to with the given alignment value. Additionally, it will detect possible overflow during multiplication.

This function is similar to g_aligned_alloc(), but it will also clear the allocated memory before returning it.

Frees the memory allocated by g_aligned_alloc().

Frees the memory pointed to by @mem, assuming it is has the given @size and

Determines the numeric value of a character as a decimal digit. If the character is not a decimal digit according to func@GLib.ascii_isdigit, -1 is returned.

Compare two strings, ignoring the case of ASCII characters.

Converts all upper case ASCII letters to lower case ASCII letters, with semantics that exactly match func@GLib.ascii_tolower.

Compare @s1 and @s2, ignoring the case of ASCII characters and any characters after the first @n in each string. If either string is less than @n bytes long, comparison will stop at the first nul byte encountered.

Converts all lower case ASCII letters to upper case ASCII letters, with semantics that exactly match func@GLib.ascii_toupper.

Convert a character to ASCII lower case. If the character is not an ASCII upper case letter, it is returned unchanged.

Convert a character to ASCII upper case. If the character is not an ASCII lower case letter, it is returned unchanged.

Determines the numeric value of a character as a hexadecimal digit. If the character is not a hex digit according to func@GLib.ascii_isxdigit, -1 is returned.

Internal function used to print messages from the public g_assert() and g_assert_not_reached() macros.

Atomically acquires a reference on the data pointed by @mem_block.

Allocates @block_size bytes of memory, and adds atomic reference counting semantics to it.

Allocates @block_size bytes of memory, and adds atomic reference counting semantics to it.

Allocates a new block of data with atomic reference counting semantics, and copies @block_size bytes of @mem_block into it.

Retrieves the size of the reference counted data pointed by @mem_block.

Atomically releases a reference on the data pointed by @mem_block.

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.

Creates a filename from a vector of elements using the correct separator for the current platform.

Behaves exactly like g_build_path(), but takes the path elements as a string array, instead of variadic arguments.

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.

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

Sets a function to be called when the child indicated by @pid exits, at the priority @priority.

Creates a new child_watch source.

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. In case of success, %errno is undefined.

Close every file descriptor equal to or greater than @lowfd.

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().

Destroys the dataset, freeing all memory allocated, and calling any destroy functions set for data elements.

Calls the given function for each data element which is associated with the given location. Note that this function is NOT thread-safe. So unless @dataset_location can be protected from any modifications during invocation of this function, it should not be called.

Gets the data element corresponding to a #GQuark.

Removes an element, without calling its destroy notification function.

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.

Compares two #gpointer arguments and returns true if they are equal. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using opaque pointers compared by pointer value as keys in a #GHashTable.

Converts a gpointer to a hash value. It can be passed to g_hash_table_new() as the @hash_func parameter, when using opaque pointers compared by pointer value as keys in a #GHashTable.

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.

Compares the two #gdouble values being pointed to and returns true if they are equal. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-null pointers to doubles as keys in a #GHashTable.

Converts a pointer to a #gdouble to a hash value. It can be passed to g_hash_table_new() as the @hash_func parameter, It can be passed to g_hash_table_new() as the @hash_func parameter, when using non-null pointers to doubles as keys in a #GHashTable.

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.

Mark every file descriptor equal to or greater than @lowfd to be closed at the next execve() or similar, as if via the FD_CLOEXEC flag.

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.

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.

Frees the memory pointed to by @mem.

Frees the memory pointed to by @mem, assuming it is has the given @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.