Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://developer.gnome.org/glib/unstable/func.pointer_bit_lock.html below:

GLib – 2.0

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.

since: 2.8

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.

since: 2.72

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

since: 2.72

Frees the memory allocated by g_aligned_alloc().

since: 2.72

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

since: 2.76

Determines the numeric value of a character as a decimal digit. If the character is not a decimal digit according to g_ascii_isdigit(), -1 is returned.

Converts a gdouble to a string, using the ‘.’ as decimal point.

Converts a gdouble to a string, using the ‘.’ as decimal point. To format the number you pass in a printf()-style format string. Allowed conversion specifiers are ‘e’, ‘E’, ‘f’, ‘F’, ‘g’ and ‘G’.

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

A convenience function for converting a string to a signed number.

since: 2.54

A convenience function for converting a string to an unsigned number.

since: 2.54

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 a string to a floating point value.

Converts a string to a gint64 value.

since: 2.12

Converts a string to a guint64 value.

since: 2.2

Converts all lower case ASCII letters to upper case ASCII letters, with semantics that exactly match g_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 g_ascii_isxdigit(), -1 is returned.

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

Specifies a function to be called at normal program termination.

deprecated: 2.32 

Atomically adds val to the value of atomic.

since: 2.4

Performs an atomic bitwise ‘and’ of the value of atomic and val, storing the result back in atomic.

since: 2.30

Compares atomic to oldval and, if equal, sets it to newval. If atomic was not equal to oldval then no change occurs.

since: 2.4

Compares atomic to oldval and, if equal, sets it to newval. If atomic was not equal to oldval then no change occurs. In any case the value of atomic before this operation is stored in preval.

since: 2.74

Decrements the value of atomic by 1.

since: 2.4

Sets the atomic to newval and returns the old value from atomic.

since: 2.74

This function existed before g_atomic_int_add() returned the prior value of the integer (which it now does). It is retained only for compatibility reasons. Don’t use this function in new code.

deprecated: 2.30 since: 2.4

Gets the current value of atomic.

since: 2.4

Increments the value of atomic by 1.

since: 2.4

Performs an atomic bitwise ‘or’ of the value of atomic and val, storing the result back in atomic.

since: 2.30

Sets the value of atomic to newval.

since: 2.4

Performs an atomic bitwise ‘xor’ of the value of atomic and val, storing the result back in atomic.

since: 2.30

Atomically adds val to the value of atomic.

since: 2.30

Performs an atomic bitwise ‘and’ of the value of atomic and val, storing the result back in atomic.

since: 2.30

Compares atomic to oldval and, if equal, sets it to newval. If atomic was not equal to oldval then no change occurs.

since: 2.4

Compares atomic to oldval and, if equal, sets it to newval. If atomic was not equal to oldval then no change occurs. In any case the value of atomic before this operation is stored in preval.

since: 2.74

Sets the atomic to newval and returns the old value from atomic.

since: 2.74

Gets the current value of atomic.

since: 2.4

Performs an atomic bitwise ‘or’ of the value of atomic and val, storing the result back in atomic.

since: 2.30

Sets the value of atomic to newval.

since: 2.4

Performs an atomic bitwise ‘xor’ of the value of atomic and val, storing the result back in atomic.

since: 2.30

Atomically acquires a reference on the data pointed by mem_block.

since: 2.58

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

since: 2.58

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

since: 2.58

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

since: 2.58

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

since: 2.58

Atomically releases a reference on the data pointed by mem_block.

since: 2.58

Atomically releases a reference on the data pointed by mem_block.

since: 2.58

Atomically compares the current value of arc with val.

since: 2.58

Atomically decreases the reference count.

since: 2.58

Atomically increases the reference count.

since: 2.58

Initializes a reference count variable to 1.

since: 2.58

Decode a sequence of Base-64 encoded text into binary data. Note that the returned binary data is not necessarily zero-terminated, so it should not be used as a character string.

since: 2.12

Decode a sequence of Base-64 encoded text into binary data by overwriting the input data.

since: 2.20

Incrementally decode a sequence of binary data from its Base-64 stringified representation. By calling this function multiple times you can convert data in chunks to avoid having to have the full encoded data in memory.

since: 2.12

Encode a sequence of binary data into its Base-64 stringified representation.

since: 2.12

Flush the status from a sequence of calls to g_base64_encode_step().

since: 2.12

Incrementally encode a sequence of binary data into its Base-64 stringified representation. By calling this function multiple times you can convert data in chunks to avoid having to have the full encoded data in memory.

since: 2.12

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

deprecated: 2.2 

Sets the indicated lock_bit in address. If the bit is already set, this call will block until g_bit_unlock() unsets the corresponding bit.

since: 2.24

Sets the indicated lock_bit in address and atomically returns the new value.

unstable since: 2.86

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.

Sets the indicated lock_bit in address, returning TRUE if successful. If the bit is already set, returns FALSE immediately.

since: 2.24

Clears the indicated lock_bit in address. If another thread is currently blocked in g_bit_lock() on this same bit then it will be woken up.

since: 2.24

This is like g_bit_unlock() but also atomically sets address to val.

unstable since: 2.86

deprecated: 2.10 

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

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

since: 2.56

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

since: 2.8

Creates a path from a series of elements using separator as the separator between elements.

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

since: 2.8

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

since: 2.58

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

since: 2.8

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

since: 2.6

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

since: 2.4

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

since: 2.4

Creates a new child_watch source.

since: 2.4

A wrapper for the POSIX chmod() function. The chmod() function is used to set the permissions of a file system object.

since: 2.8

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

If fd_ptr points to a file descriptor, close it and return whether closing it was successful, like g_close(). If fd_ptr points to a negative number, return TRUE without closing anything. In both cases, set fd_ptr to -1 before returning.

since: 2.76

Clears a numeric handler, such as a GSource ID.

since: 2.56

Clears a pointer to a GList, freeing it and, optionally, freeing its elements using destroy.

since: 2.64

Clears a reference to a variable.

since: 2.34

Clears a pointer to a GSList, freeing it and, optionally, freeing its elements using destroy.

since: 2.64

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.

since: 2.36

Close every file descriptor equal to or greater than lowfd.

since: 2.80

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

since: 2.34

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

since: 2.16

Computes the checksum of a string.

since: 2.16

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

since: 2.50

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

since: 2.30

Computes the HMAC for a string.

since: 2.30

Converts a string from one character set to another.

Converts a string from one character set to another, possibly including fallback sequences for characters not representable in the output. Note that it is not guaranteed that the specification for the fallback sequences in fallback will be honored. Some systems may do an approximate conversion from from_codeset to to_codeset in their iconv() functions, in which case GLib will simply return that approximate conversion.

Converts a string from one character set to another.

A wrapper for the POSIX creat() function. The creat() function is used to convert a pathname into a file descriptor, creating a file if necessary.

since: 2.8

Frees all the data elements of the datalist. The data elements’ destroy functions are called if they have been set.

Calls the given function for each data element of the datalist. The function is called with each data element’s GQuark id and data, together with the given user_data parameter. Note that this function is NOT thread-safe. So unless datalist can be protected from any modifications during invocation of this function, it should not be called.

Gets a data element, using its string identifier. This is slower than g_datalist_id_get_data() because it compares strings.

Gets flags values packed in together with the datalist. See g_datalist_set_flags().

since: 2.8

This is a variant of g_datalist_id_get_data() which returns a ‘duplicate’ of the value. dup_func defines the meaning of ‘duplicate’ in this context, it could e.g. take a reference on a ref-counted object.

since: 2.34

Retrieves the data element corresponding to key_id.

Removes multiple keys from a datalist.

since: 2.74

Removes an element, without calling its destroy notification function.

Compares the member that is associated with key_id in datalist to oldval, and if they are the same, replace oldval with newval.

since: 2.34

Sets the data corresponding to the given GQuark id, and the function to be called when the element is removed from the datalist. Any previous data with the same key is removed, and its destroy function is called.

Resets the datalist to NULL. It does not free any memory or call any destroy functions.

Turns on flag values for a data list. This function is used to keep a small number of boolean flags in an object with a data list without using any additional space. It is not generally useful except in circumstances where space is very tight. (It is used in the base GObject type, for example.).

since: 2.8

Turns off flag values for a data list. See g_datalist_unset_flags().

since: 2.8

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.

Sets the data element associated with the given GQuark id, and also the function to call when the data element is destroyed. Any previous data with the same key is removed, and its destroy function is called.

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.

since: 2.26

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.

since: 2.18

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.

since: 2.18

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.

since: 2.22

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.

since: 2.22

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.

since: 2.16

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.

since: 2.18

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

since: 2.32

Sets the environment variable variable in the provided list envp to value.

since: 2.32

Removes the environment variable variable from the provided environment envp.

since: 2.32

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.

since: 2.80

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

Reads an entire file into allocated memory, with good error checking.

Opens a file for writing in the preferred directory for temporary files (as returned by g_get_tmp_dir()).

Reads the contents of the symbolic link filename like the POSIX readlink() function.

since: 2.4

Writes all of contents to a file named filename. This is a convenience wrapper around calling g_file_set_contents_full() with flags set to G_FILE_SET_CONTENTS_CONSISTENT | G_FILE_SET_CONTENTS_ONLY_EXISTING and mode set to 0666.

since: 2.8

Writes all of contents to a file named filename, with good error checking. If a file called filename already exists it will be overwritten.

since: 2.66

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.

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.

since: 2.6

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.

since: 2.6

Converts an escaped ASCII-encoded URI to a local filename in the encoding used for filenames.

Converts a string from UTF-8 to the encoding GLib uses for filenames. Note that on Windows GLib uses UTF-8 for filenames; on other platforms, this function indirectly depends on the current locale.

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

Converts a string which is in the encoding used by GLib for filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8 for filenames; on other platforms, this function indirectly depends on the current locale.

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 program if program exists and is executable, and NULL otherwise.

On Windows, if program does not have a file type suffix, tries with the suffixes .exe, .cmd, .bat and .com, and the suffixes in the PATHEXT environment variable.

A wrapper for the stdio fopen() function. The fopen() function opens a file and associates a new stream with it.

since: 2.6

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.

since: 2.30

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

deprecated: 2.30 since: 2.16

Formats a size.

since: 2.30

An implementation of the standard fprintf() function which supports positional parameters, as specified in the Single Unix Specification.

since: 2.2

Frees the memory pointed to by mem.

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

since: 2.76

A wrapper for the POSIX freopen() function. The freopen() function opens a file and associates it with an existing stream.

since: 2.6

A wrapper for the POSIX fsync() function. On Windows, _commit() will be used. On macOS, fcntl(F_FULLFSYNC) will be used. The fsync() function is used to synchronize a file’s in-core state with that of the disk.

since: 2.64

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

since: 2.2

Obtains the character set for the current locale; you might use this character set as an argument to g_convert(), to convert from the current locale’s encoding to some other encoding. (Frequently g_locale_to_utf8() and g_locale_from_utf8() are nice shortcuts, though.).

Gets the character set for the current locale.

Obtains the character set used by the console attached to the process, which is suitable for printing output to the terminal.

since: 2.62

Gets the current directory.

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

deprecated: 2.62 

Gets the list of environment variables for the current process.

since: 2.28

Determines the preferred character sets used for filenames. The first character set from the charsets is the filename encoding, the subsequent character sets are used when trying to generate a displayable representation of a filename, see g_filename_display_name().

since: 2.6

Gets the current user’s home directory.

Return a name for the machine.

since: 2.8

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

since: 2.6

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

since: 2.58

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 setlocale(3) for information about locales and their format.

since: 2.28

Queries the system monotonic time.

since: 2.28

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.

since: 2.36

Get information about the operating system.

since: 2.64

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.

since: 2.28

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

since: 2.6

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

since: 2.6

Gets the directory to use for temporary files.

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

since: 2.6

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

since: 2.6

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

since: 2.6

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.

since: 2.28

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

since: 2.14

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

since: 2.72

Returns the value of an environment variable.

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.

since: 2.22

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

since: 2.22

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.

since: 2.22

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

since: 2.22

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.

since: 2.22

Same as the standard UNIX routine iconv(), but may be implemented via libiconv on UNIX flavors that lack a native implementation.

Adds a function to be called whenever there are no higher priority events pending to the default main loop. The function is given the default idle priority, G_PRIORITY_DEFAULT_IDLE. If the function returns FALSE it is automatically removed from the list of event sources and will not be called again.

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

Adds a function to be called whenever there are no higher priority events pending to the default main loop. The function is given the default idle priority, G_PRIORITY_DEFAULT_IDLE.

since: 2.74

Removes the idle function with the given data.

Creates a new idle source.

Compares the two #gint64 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 64-bit integers as keys in a GHashTable.

since: 2.22

Converts a pointer to a #gint64 to a hash value.

since: 2.22

Compares the two #gint 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 integers as keys in a GHashTable.

Converts a pointer to a #gint to a hash value. It can be passed to g_hash_table_new() as the hash_func parameter, when using non-NULL pointers to integer values as keys in a GHashTable.

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.

since: 2.10

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

since: 2.10

Adds the GIOChannel into the default main loop context with the default priority.

Adds the GIOChannel into the default main loop context with the given priority.

Creates a GSource that’s dispatched when condition is met for the given channel. For example, if condition is G_IO_IN, the source will be dispatched when there’s data available for reading.

Gets the names of all variables set in the environment.

since: 2.8

Converts a string from UTF-8 to the encoding used for strings by the C runtime (usually the same as that used by the operating system) in the current locale. On Windows this means the system codepage.

Converts a string which is in the encoding used for strings by the C runtime (usually the same as that used by the operating system) in the current locale into a UTF-8 string.

Logs an error or debugging message.

The default log handler set up by GLib; g_log_set_default_handler() allows to install an alternate default log handler.

Gets the current fatal mask.

unstable since: 2.86

Return whether debug output from the GLib logging system is enabled.

since: 2.72

Removes the log handler.

Sets the message levels which are always fatal, in any log domain.

Enable or disable debug output from the GLib logging system for all domains.

since: 2.72

Installs a default log handler which is used if no log handler has been set for the particular log domain and log level combination.

since: 2.6

Sets the log levels which are fatal in the given domain.

Sets the log handler for a domain and a set of log levels.

Like g_log_set_handler(), but takes a destroy notify for the user_data.

since: 2.46

Set a writer function which will be called to format and write out each log message.

since: 2.50

Log a message with structured data.

since: 2.50

Log a message with structured data.

since: 2.50

Log a message with structured data, accepting the data within a GVariant.

since: 2.50

Format a structured log message and output it to the default log destination for the platform.

since: 2.50

Reset the list of domains to be logged, that might be initially set by the G_MESSAGES_DEBUG or DEBUG_INVOCATION environment variables.

since: 2.80

Configure whether the built-in log functions will output all log messages to stderr.

since: 2.68

Check whether g_log_writer_default() and g_log_default_handler() would ignore a message with the given domain and level.

since: 2.68

Format a structured log message as a string suitable for outputting to the terminal (or elsewhere).

since: 2.50

Check whether the given output_fd file descriptor is a connection to the systemd journal, or something else (like a log file or stdout or stderr).

since: 2.50

Format a structured log message and send it to the systemd journal as a set of key–value pairs.

since: 2.50

Format a structured log message and print it to either stdout or stderr, depending on its log level.

since: 2.50

Check whether the given output_fd file descriptor supports ANSI color escape sequences.

since: 2.50

Format a structured log message and send it to the syslog daemon. Only fields which are understood by this function are included in the formatted string which is printed.

since: 2.80

Logs an error or debugging message.

A wrapper for the POSIX lstat() function. The lstat() function is like stat() except that in the case of symbolic links, it returns information about the symbolic link itself and not the file that it refers to. If the system does not support symbolic links g_lstat() is identical to g_stat().

since: 2.6

Returns the currently firing source for this thread.

since: 2.12

Returns the depth of the stack of calls to g_main_context_dispatch() on any GMainContext in the current thread. That is, when called from the toplevel, it gives 0. When called from within a callback from g_main_context_iteration() (or g_main_loop_run(), etc.) it returns 1. When called from within a callback to a recursive call to g_main_context_iteration(), it returns 2. And so forth.

Allocates n_bytes bytes of memory. If n_bytes is 0 it returns NULL.

Allocates n_bytes bytes of memory, initialized to 0’s. If n_bytes is 0 it returns NULL.

This function is similar to g_malloc0(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication.

since: 2.24

This function is similar to g_malloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication.

since: 2.24

Collects the attributes of the element from the data passed to the GMarkupParser start_element function, dealing with common error conditions and supporting boolean values.

since: 2.16

Escapes text so that the markup parser will parse it verbatim. Less than, greater than, ampersand, etc. are replaced with the corresponding entities. This function would typically be used when writing out a file to be parsed with the markup parser.

Formats arguments according to format, escaping all string and character arguments in the fashion of g_markup_escape_text(). This is useful when you want to insert literal strings into XML-style markup output, without having to worry that the strings might themselves contain markup.

since: 2.4

Formats the data in args according to format, escaping all string and character arguments in the fashion of g_markup_escape_text(). See g_markup_printf_escaped().

since: 2.4

Checks whether the allocator used by g_malloc() is the system’s malloc implementation. If it returns TRUE memory allocated with malloc() can be used interchangeably with memory allocated using g_malloc(). This function is useful for avoiding an extra copy of allocated memory returned by a non-GLib-based API.

deprecated: 2.46 

GLib used to support some tools for memory profiling, but this no longer works. There are many other useful tools for memory profiling these days which can be used instead.

deprecated: 2.46 

This function used to let you override the memory allocation function. However, its use was incompatible with the use of global constructors in GLib and GIO, because those use the GLib allocators before main is reached. Therefore this function is now deprecated and is just a stub.

deprecated: 2.46 

Allocates byte_size bytes of memory, and copies byte_size bytes into it from mem. If mem is NULL it returns NULL.

deprecated: 2.68 

Allocates byte_size bytes of memory, and copies byte_size bytes into it from mem. If mem is NULL it returns NULL.

since: 2.68

A wrapper for the POSIX mkdir() function. The mkdir() function attempts to create a directory with the given name and permissions. The mode argument is ignored on Windows.

since: 2.6

Create a directory if it doesn’t already exist. Create intermediate parent directories as needed, too.

since: 2.8

Creates a temporary directory in the current directory.

since: 2.30

Creates a temporary directory in the current directory.

since: 2.30

Opens a temporary file in the current directory.

Opens a temporary file in the current directory.

since: 2.22

Set the pointer at the specified location to NULL.

Prompts the user with [E]xit, [H]alt, show [S]tack trace or [P]roceed. This function is intended to be used for debugging use only. The following example shows how it can be used together with the g_log() functions.

Invokes gdb, which attaches to the current process and shows a stack trace. Called by g_on_error_query() when the “[S]tack trace” option is selected. You can get the current process’s program name with g_get_prgname(), assuming that you have called gtk_init() or gdk_init().

A wrapper for the POSIX open() function. The open() function is used to convert a pathname into a file descriptor.

since: 2.6

Parses a string containing debugging options into a %guint containing bit flags. This is used within GDK and GTK to parse the debug options passed on the command line or through environment variables.

Gets the last component of the filename.

Gets the directory components of a file name. For example, the directory component of /usr/bin/test is /usr/bin. The directory component of / is /.

Returns TRUE if the given file_name is an absolute file name. Note that this is a somewhat vague concept on Windows.

Returns a pointer into file_name after the root component, i.e. after the “/” in UNIX or “C:" under Windows. If file_name is not an absolute path it returns NULL.

Matches a string against a compiled pattern.

deprecated: 2.70 

Matches a string against a pattern given as a string.

Matches a string against a compiled pattern.

deprecated: 2.70 

This is equivalent to g_bit_lock, but working on pointers (or other pointer-sized values).

since: 2.30

This is equivalent to g_bit_lock, but working on pointers (or other pointer-sized values).

since: 2.80

This mangles ptr as g_pointer_bit_lock() and g_pointer_bit_unlock() do.

since: 2.80

This is equivalent to g_bit_trylock(), but working on pointers (or other pointer-sized values).

since: 2.30

This is equivalent to g_bit_unlock, but working on pointers (or other pointer-sized values).

since: 2.30

This is equivalent to g_pointer_bit_unlock() and atomically setting the pointer value.

since: 2.80

Polls fds, as with the poll() system call, but portably. (On systems that don’t have poll(), it is emulated using select().) This is used internally by GMainContext, but it can be called directly if you need to block until a file descriptor is ready, but don’t want to run the full main loop.

since: 2.20

Formats a string according to format and prefix it to an existing error message. If err is NULL (ie: no error variable) then do nothing.

since: 2.16

Prefixes prefix to an existing error message. If err or *err is NULL (i.e.: no error variable) then do nothing.

since: 2.70

Outputs a formatted message via the print handler.

Outputs a formatted message via the error message handler.

An implementation of the standard printf() function which supports positional parameters, as specified in the Single Unix Specification.

since: 2.2

Calculates the maximum space needed to store the output of the sprintf() function.

If dest is NULL, free src; otherwise, moves src into *dest. The error variable dest points to must be NULL.

If dest is NULL, free src; otherwise, moves src into *dest. *dest must be NULL. After the move, add a prefix as with g_prefix_error().

since: 2.16

This is just like the standard C qsort() function, but the comparison routine accepts a user data argument (like qsort_r()).

deprecated: 2.82 

Gets the GQuark identifying the given (static) string. If the string does not currently have an associated GQuark, a new GQuark is created, linked to the given string.

Gets the GQuark identifying the given string. If the string does not currently have an associated GQuark, a new GQuark is created, using a copy of the string.

Gets the string associated with the given GQuark.

Gets the GQuark associated with the given string, or 0 if string is NULL or it has no associated GQuark.

Returns a random #gdouble equally distributed over the range [0..1).

Returns a random #gdouble equally distributed over the range [begin..end).

Return a random #guint32 equally distributed over the range [0..2^32-1].

Returns a random #gint32 equally distributed over the range [begin..end-1].

Sets the seed for the global random number generator, which is used by the g_random_* functions, to seed.

Acquires a reference on the data pointed by mem_block.

since: 2.58

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

since: 2.58

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

since: 2.58

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

since: 2.58

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

since: 2.58

Releases a reference on the data pointed by mem_block.

since: 2.58

Releases a reference on the data pointed by mem_block.

since: 2.58

Reallocates the memory pointed to by mem, so that it now has space for n_bytes bytes of memory. It returns the new address of the memory, which may have been moved. mem may be NULL, in which case it’s considered to have zero-length. n_bytes may be 0, in which case NULL will be returned and mem will be freed unless it is NULL.

This function is similar to g_realloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication.

since: 2.24

Compares the current value of rc with val.

since: 2.58

Decreases the reference count.

since: 2.58

Increases the reference count.

since: 2.58

Initializes a reference count variable to 1.

since: 2.58

Acquires a reference on a string.

since: 2.58

Compares two ref-counted strings for byte-by-byte equality.

since: 2.84

Retrieves the length of str.

since: 2.58

Creates a new reference counted string and copies the contents of str into it.

since: 2.58

Creates a new reference counted string and copies the content of str into it.

since: 2.58

Creates a new reference counted string and copies the contents of str into it, up to len bytes.

since: 2.58

Releases a reference on a string; if it was the last reference, the resources allocated by the string are freed as well.

since: 2.58

Resets the cache used for g_get_user_special_dir(), so that the latest on-disk version is used. Call this only if you just changed the data on disk yourself.

since: 2.22

A wrapper for the POSIX remove() function. The remove() function deletes a name from the filesystem.

since: 2.6

A wrapper for the POSIX rename() function. The rename() function renames a file, moving it between directories if required.

since: 2.6

Internal function used to print messages from the public g_return_if_fail() and g_return_val_if_fail() macros.

A wrapper for the POSIX rmdir() function. The rmdir() function deletes a directory from the filesystem.

since: 2.6

Sets a human-readable name for the application. This name should be localized if possible, and is intended for display to the user. Contrast with g_set_prgname(), which sets a non-localized name. g_set_prgname() will be called automatically by gtk_init(), but g_set_application_name() will not.

since: 2.2

Does nothing if err is NULL; if err is non-NULL, then *err must be NULL. A new GError is created and assigned to *err.

Does nothing if err is NULL; if err is non-NULL, then *err must be NULL. A new GError is created and assigned to *err. Unlike g_set_error(), message is not a printf()-style format string. Use this function if message contains text you don’t have control over, that could include printf() escape sequences.

since: 2.18

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

Sets the print handler to func, or resets it to the default GLib handler if NULL.

Sets the handler for printing error messages to func, or resets it to the default GLib handler if NULL.

Updates a pointer to a string to a copy of new_str and returns whether the string was changed.

since: 2.76

Sets an environment variable. On UNIX, both the variable’s name and value can be arbitrary byte strings, except that the variable’s name cannot contain ‘=’. On Windows, they should be in UTF-8.

since: 2.4

Parses a command line into an argument vector, in much the same way the shell would, but without many of the expansions the shell would perform (variable expansion, globs, operators, filename expansion, etc. are not supported).

Quotes a string so that the shell (/bin/sh) will interpret the quoted string to mean unquoted_string.

Unquotes a string as the shell (/bin/sh) would.

Allocates a block of memory from the libc allocator.

since: 2.10

Allocates a block of memory via g_slice_alloc() and initializes the returned memory to 0.

since: 2.10

Allocates a block of memory from the slice allocator and copies block_size bytes into it from mem_block.

since: 2.14

Frees a block of memory.

since: 2.10

Frees a linked list of memory blocks of structure type type.

since: 2.10

A safer form of the standard sprintf() function. The output is guaranteed to not exceed n characters (including the terminating nul character), so it is easy to ensure that a buffer overflow cannot occur.

This is just like the standard C qsort() function, but the comparison routine accepts a user data argument (like qsort_r()).

since: 2.82

Gets the smallest prime number from a built-in array of primes which is larger than num. This is used within GLib to calculate the optimum size of a GHashTable.

Executes a child program asynchronously.

Executes a child program asynchronously.

since: 2.58

Identical to g_spawn_async_with_pipes_and_fds() but with n_fds set to zero, so no FD assignments are used.

Executes a child program asynchronously (your program will not block waiting for the child to exit).

since: 2.68

An old name for g_spawn_check_wait_status(), deprecated because its name is misleading.

deprecated: 2.70 since: 2.34

Set error if wait_status indicates the child exited abnormally (e.g. with a nonzero exit code, or via a fatal signal).

since: 2.70

On some platforms, notably Windows, the GPid type represents a resource which must be closed to prevent resource leaking. g_spawn_close_pid() is provided for this purpose. It should be used on all platforms, even though it doesn’t do anything under UNIX.

A simple version of g_spawn_async() that parses a command line with g_shell_parse_argv() and passes it to g_spawn_async().

A simple version of g_spawn_sync() with little-used parameters removed, taking a command line instead of an argument vector.

Executes a child synchronously (waits for the child to exit before returning).

An implementation of the standard sprintf() function which supports positional parameters, as specified in the Single Unix Specification.

since: 2.2

A wrapper for the POSIX stat() function. The stat() function returns information about a file. On Windows the stat() function in the C library checks only the FAT-style READONLY attribute and does not look at the ACL at all. Thus on Windows the protection bits in the st_mode field are a fabrication of little use.

since: 2.6

Sets fd_ptr to -1, returning the value that was there before.

since: 2.70

Sets handle_pointer to 0, returning the value that was there before.

since: 2.84

Sets pp to NULL, returning the value that was there before.

since: 2.44

Copies a nul-terminated string into the destination buffer, including the trailing nul byte, and returns a pointer to the trailing nul byte in dest. The return value is useful for concatenating multiple strings without having to repeatedly scan for the end.

Compares two strings for byte-by-byte equality 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 strings as keys in a GHashTable.

Looks whether the string str begins with prefix.

since: 2.2

Looks whether a string ends with suffix.

since: 2.2

Converts a string to a hash value.

Determines if a string is pure ASCII. A string is pure ASCII if it contains no bytes with the high bit set.

since: 2.40

Checks if a search conducted for search_term should match potential_hit.

since: 2.40

Transliterate str to plain ASCII.

since: 2.40

Tokenizes string and performs folding on each token.

since: 2.40

For each character in string, if the character is not in valid_chars, replaces the character with substitutor.

A case-insensitive string comparison, corresponding to the standard strcasecmp() function on platforms which support it.

deprecated: 2.2 

Removes trailing whitespace from a string.

Removes leading whitespace from a string, by moving the rest of the characters forward.

Compares str1 and str2 like strcmp().

since: 2.16

Makes a copy of a string replacing C string-style escape sequences with their one byte equivalent:.

Concatenates all of the given strings into one long string.

Converts any delimiter characters in string to new_delimiter.

Converts a string to lower case.

deprecated: 2.2 

Duplicates a string. If str is NULL it returns NULL.

Similar to the standard C sprintf() function but safer, since it calculates the maximum space required and allocates memory to hold the result.

Similar to the standard C vsprintf() function but safer, since it calculates the maximum space required and allocates memory to hold the result.

Copies an array of strings. The copy is a deep copy; each string is also copied.

Returns a string corresponding to the given error code, e.g. “no such process”.

It replaces the following special characters in the string source with their corresponding C escape sequence:.

Frees an array of strings, as well as each string it contains.

An auxiliary function for gettext() support (see Q_()).

since: 2.4

Joins a number of strings together to form one long string, with the optional separator inserted between each of them.

Joins an array of strings together to form one long string, with the optional separator inserted between each of them.

Portability wrapper that calls strlcat() on systems which have it, and emulates it otherwise. Appends nul-terminated src string to dest, guaranteeing nul-termination for dest. The total size of dest won’t exceed dest_size.

Portability wrapper that calls strlcpy() on systems which have it, and emulates strlcpy() otherwise. Copies src to dest; dest is guaranteed to be nul-terminated; src must be nul-terminated; dest_size is the buffer size, not the number of bytes to copy.

A case-insensitive string comparison, corresponding to the standard strncasecmp() function on platforms which support it. It is similar to g_strcasecmp() except it only compares the first n characters of the strings.

deprecated: 2.2 

Duplicates the first n bytes of a string, returning a newly-allocated buffer n + 1 bytes long which will always be nul-terminated. If str is less than n bytes long the buffer is padded with nuls. If str is NULL it returns NULL.

Creates a new string length bytes long filled with fill_char.

Reverses all of the bytes in a string. For example, g_strreverse ("abcdef") will result in “fedcba”.

Searches the string haystack for the last occurrence of the string needle.

Searches the string haystack for the last occurrence of the string needle, limiting the length of the search to haystack_len.

Returns a string describing the given signal, e.g. “Segmentation fault”. If the signal is unknown, it returns “unknown signal (<signum>)”.

Splits a string into a maximum of max_tokens pieces, using the given delimiter. If max_tokens is reached, the remainder of string is appended to the last token.

Splits string into a number of tokens not containing any of the characters in delimiters. A token is the (possibly empty) longest string that does not contain any of the characters in delimiters. If max_tokens is reached, the remainder is appended to the last token.

since: 2.4

Searches the string haystack for the first occurrence of the string needle, limiting the length of the search to haystack_len or a nul terminator byte (whichever is reached first).

Converts a string to a floating point value.

Converts a string to upper case.

deprecated: 2.2 

Checks if an array of strings contains the string str according to g_str_equal(). strv must not be NULL.

since: 2.44

Checks if two arrays of strings contain exactly the same elements in exactly the same order.

since: 2.60

Returns the length of an array of strings. str_array must not be NULL.

since: 2.6

Creates a new test case.

since: 2.16

Creates a new test case.

since: 2.34

Creates a new test case.

since: 2.16

Adds a message to test reports that associates a bug URI with a test case.

since: 2.16

Specifies the base URI for bug reports.

since: 2.16

Creates the pathname to a data file that is required for a test.

since: 2.38

Creates a new GTestCase.

since: 2.16

Creates a new test suite with the name suite_name.

since: 2.16

Attempts to disable system crash reporting infrastructure.

since: 2.78

Indicates that a message with the given log_domain and log_level, with text matching pattern, is expected to be logged.

since: 2.34

Indicates that a test failed.

since: 2.30

Indicates that a test failed and records a message.

since: 2.70

Returns whether a test has already failed.

since: 2.38

Gets the pathname of the directory containing test files of the type specified by file_type.

since: 2.38

Gets the pathname to a data file that is required for a test.

since: 2.38

Gets the test path for the test currently being run.

since: 2.68

Gets the toplevel test suite for the test path API.

since: 2.16

Indicates that a test failed because of some incomplete functionality.

since: 2.38

Indicates that a test failed because of some incomplete functionality.

since: 2.70

Initializes the GLib testing framework.

since: 2.16

Installs a non-error fatal log handler which can be used to decide whether log messages which are counted as fatal abort the program.

since: 2.22

Reports the result of a performance or measurement test.

since: 2.16

Adds a message to the test report.

since: 2.16

Reports the result of a performance or measurement test.

since: 2.16

Enqueues a callback destroy_func to be executed during the next test case teardown phase.

since: 2.16

Enqueues a pointer to be released with g_free() during the next teardown phase.

since: 2.16

Gets a reproducible random floating point number.

since: 2.16

Gets a reproducible random floating point number out of a specified range.

since: 2.16

Gets a reproducible random integer number.

since: 2.16

Gets a reproducible random integer number out of a specified range.

since: 2.16

Runs all tests under the toplevel suite.

since: 2.16

Executes the tests within suite and all nested test suites.

since: 2.16

Changes the behaviour of the various assertion macros.

since: 2.38

Indicates that a test was skipped.

since: 2.38

Indicates that a test was skipped.

since: 2.70

Returns true if the test program is running under g_test_trap_subprocess().

since: 2.38

Sets the summary for a test.

since: 2.62

Gets the number of seconds since the last start of the timer with g_test_timer_start().

since: 2.16

Reports the last result of g_test_timer_elapsed().

since: 2.16

Starts a timing test.

since: 2.16

Forks the current test program to execute a test case that might not return or that might abort.

deprecated: Unknown since: 2.16

Checks the result of the last g_test_trap_subprocess() call.

since: 2.16

Checks the result of the last g_test_trap_subprocess() call.

since: 2.16

Respawns the test program to run only test_path in a subprocess.

since: 2.38

Respawns the test program to run only test_path in a subprocess with a given environment.

since: 2.80

Sets a function to be called at regular intervals, with the default priority, G_PRIORITY_DEFAULT.

Sets a function to be called at regular intervals, with the given priority. The function is called repeatedly until it returns FALSE, at which point the timeout is automatically destroyed and the function will not be called again. The notify function is called when the timeout is destroyed. The first call to the function will be at the end of the first interval.

Sets a function to be called after interval milliseconds have elapsed, with the default priority, G_PRIORITY_DEFAULT.

since: 2.74

Sets a function to be called at regular intervals with the default priority, G_PRIORITY_DEFAULT.

since: 2.14

Sets a function to be called at regular intervals, with priority.

since: 2.14

This function behaves like g_timeout_add_once() but with a range in seconds.

since: 2.78

Creates a new timeout source.

Creates a new timeout source.

since: 2.14

Attempts to allocate n_bytes, and returns NULL on failure. Contrast with g_malloc(), which aborts the program on failure.

Attempts to allocate n_bytes, initialized to 0’s, and returns NULL on failure. Contrast with g_malloc0(), which aborts the program on failure.

since: 2.8

This function is similar to g_try_malloc0(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication.

since: 2.24

This function is similar to g_try_malloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication.

since: 2.24

Attempts to realloc mem to a new size, n_bytes, and returns NULL on failure. Contrast with g_realloc(), which aborts the program on failure.

This function is similar to g_try_realloc(), allocating (n_blocks * n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication.

since: 2.24

Convert a string from UCS-4 to UTF-16.

Convert a string from a 32-bit fixed width representation as UCS-4. to UTF-8.

Determines the break type of c. c should be a Unicode character (to derive a character from UTF-8 encoded text, use g_utf8_get_char()). The break type is used to find word and line breaks (“text boundaries”), Pango implements the Unicode boundary resolution algorithms and normally you would use a function such as pango_break() instead of caring about break types yourself.

Determines the canonical combining class of a Unicode character.

since: 2.14

Performs a single composition step of the Unicode canonical composition algorithm.

since: 2.30

Performs a single decomposition step of the Unicode canonical decomposition algorithm.

since: 2.30

Determines the numeric value of a character as a decimal digit.

Computes the canonical or compatibility decomposition of a Unicode character. For compatibility decomposition, pass TRUE for compat; for canonical decomposition pass FALSE for compat.

since: 2.30

In Unicode, some characters are “mirrored”. This means that their images are mirrored horizontally in text that is laid out from right to left. For instance, “(” would become its mirror image, “)”, in right-to-left text.

since: 2.4

Looks up the GUnicodeScript for a particular character (as defined by Unicode Standard Annex #24). No check is made for ch being a valid Unicode character; if you pass in invalid character, the result is undefined.

since: 2.14

Determines whether a character is alphanumeric. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is alphabetic (i.e. a letter). Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is a control character. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines if a given character is assigned in the Unicode standard.

Determines whether a character is numeric (i.e. a digit). This covers ASCII 0-9 and also digits in other languages/scripts. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is printable and not a space (returns FALSE for control characters, format characters, and spaces). g_unichar_isprint() is similar, but returns TRUE for spaces. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is a lowercase letter. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is a mark (non-spacing mark, combining mark, or enclosing mark in Unicode speak). Given some UTF-8 text, obtain a character value with g_utf8_get_char().

since: 2.14

Determines whether a character is printable. Unlike g_unichar_isgraph(), returns TRUE for spaces. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is punctuation or a symbol. Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines whether a character is a space, tab, or line separator (newline, carriage return, etc.). Given some UTF-8 text, obtain a character value with g_utf8_get_char().

Determines if a character is titlecase. Some characters in Unicode which are composites, such as the DZ digraph have three case variants instead of just two. The titlecase form is used at the beginning of a word where only the first letter is capitalized. The titlecase form of the DZ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z.

Determines if a character is uppercase.

Determines if a character is typically rendered in a double-width cell.

Determines if a character is typically rendered in a double-width cell under legacy East Asian locales. If a character is wide according to g_unichar_iswide(), then it is also reported wide with this function, but the converse is not necessarily true. See the Unicode Standard Annex #11 for details.

since: 2.12

Determines if a character is a hexadecimal digit.

Determines if a given character typically takes zero width when rendered. The return value is TRUE for all non-spacing and enclosing marks (e.g., combining accents), format characters, zero-width space, but not U+00AD SOFT HYPHEN.

since: 2.14

Converts a single character to UTF-8.

Converts a character to lower case.

Converts a character to the titlecase.

Converts a character to uppercase.

Classifies a Unicode character by type.

Checks whether ch is a valid Unicode character.

Determines the numeric value of a character as a hexadecimal digit.

Computes the canonical decomposition of a Unicode character.

deprecated: 2.30 

Computes the canonical ordering of a string in-place. This rearranges decomposed characters in the string according to their combining classes. See the Unicode manual for more information.

A wrapper for the POSIX unlink() function. The unlink() function deletes a name from the filesystem. If this was the last link to the file and no processes have it opened, the diskspace occupied by the file is freed.

since: 2.6

Removes an environment variable from the environment.

since: 2.4

Pauses the current thread for the given number of microseconds.

Convert a string from UTF-16 to UCS-4.

Convert a string from UTF-16 to UTF-8.

Converts a string into a form that is independent of case. The result will not correspond to any particular case, but can be compared for equality or ordered with the results of calling g_utf8_casefold() on other strings.

Compares two strings for ordering using the linguistically correct rules for the current locale. When sorting a large number of strings, it will be significantly faster to obtain collation keys with g_utf8_collate_key() and compare the keys with strcmp() when sorting instead of sorting the original strings.

Converts a string into a collation key that can be compared with other collation keys produced by the same function using strcmp().

Converts a string into a collation key that can be compared with other collation keys produced by the same function using strcmp().

since: 2.8

Finds the start of the next UTF-8 character in the string after p.

Given a position p with a UTF-8 encoded string str, find the start of the previous UTF-8 character starting before p. Returns NULL if no UTF-8 characters are present in str before p.

Converts a sequence of bytes encoded as UTF-8 to a Unicode character.

Convert a sequence of bytes encoded as UTF-8 to a Unicode character.

If the provided string is valid UTF-8, return a copy of it. If not, return a copy in which bytes that could not be interpreted as valid Unicode are replaced with the Unicode replacement character (U+FFFD).

since: 2.52

Converts a string into canonical form, standardizing such issues as whether a character with an accent is represented as a base character and combining accent or as a single precomposed character. The string has to be valid UTF-8, otherwise NULL is returned. You should generally call g_utf8_normalize() before comparing two Unicode strings.

Converts from an integer character offset to a pointer to a position within the string.

Converts from a pointer to position within a string to an integer character offset.

Finds the previous UTF-8 character in the string before p.

Finds the leftmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to len bytes.

Converts all Unicode characters in the string that have a case to lowercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string changing.

Computes the length of the string in characters, not including the terminating nul character. If the max’th byte falls in the middle of a character, the last (partial) character is not counted.

Like the standard C strncpy() function, but copies a given number of characters instead of a given number of bytes.

Find the rightmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to len bytes.

Reverses a UTF-8 string.

since: 2.2

Converts all Unicode characters in the string that have a case to uppercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string increasing. (For instance, the German ess-zet will be changed to SS.).

Copies a substring out of a UTF-8 encoded string. The substring will contain end_pos - start_pos characters.

since: 2.30

Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4.

Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4, assuming valid UTF-8 input.

Convert a string from UTF-8 to UTF-16.

Cuts off the middle of the string, preserving half of truncate_length characters at the beginning and half at the end.

since: 2.78

Validates UTF-8 encoded text.

Validates UTF-8 encoded text.

since: 2.60

A wrapper for the POSIX utime() function. The utime() function sets the access and modification timestamps of a file.

since: 2.18

Parses the string str and verify if it is a UUID.

since: 2.52

Generates a random UUID (RFC 4122 version 4) as a string. It has the same randomness guarantees as GRand, so must not be used for cryptographic purposes such as key generation, nonces, salts or one-time pads.

since: 2.52

An implementation of the GNU vasprintf() function which supports positional parameters, as specified in the Single Unix Specification. This function is similar to g_vsprintf(), except that it allocates a string to hold the output, instead of putting the output in a buffer you allocate in advance.

since: 2.4

An implementation of the standard fprintf() function which supports positional parameters, as specified in the Single Unix Specification.

since: 2.2

An implementation of the standard vprintf() function which supports positional parameters, as specified in the Single Unix Specification.

since: 2.2

A safer form of the standard vsprintf() function. The output is guaranteed to not exceed n characters (including the terminating nul character), so it is easy to ensure that a buffer overflow cannot occur.

An implementation of the standard vsprintf() function which supports positional parameters, as specified in the Single Unix Specification.

since: 2.2

Internal function used to print messages from the public g_warn_if_reached() and g_warn_if_fail() macros.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4