Namespace
GLib – 2.0
GLib is a general-purpose, portable utility library, which provides many useful data types, macros, type conversions, string utilities, file utilities, a mainloop abstraction, and so on.
Related libraries
GModule | Portable API for dynamically loading modules |
Browse documentation | |
GObject | The base type system library |
Browse documentation | |
GIO | GObject Interfaces and Objects, Networking, IPC, and I/O |
Browse documentation |
Additional documentation
- Building GLib
- Compiling GLib Applications
- Cross-compiling the GLib package
- Running GLib Applications
- GVariant Format Strings
- GVariant Text Format
- Character set conversions
- Internationalization
- Macros
- Conversion Macros
- Automatic Cleanup
- Memory Slices
- Error Reporting
- Message Logging
- The Main Event Loop
- Reference Counting
- Testing Framework
- Threads
- Classes Hierarchy
Structs
Array |
Contains the public fields of a GArray. |
AsyncQueue |
An opaque data structure which represents an asynchronous queue. |
BookmarkFile |
An opaque data structure representing a set of bookmarks. |
ByteArray |
Contains the public fields of a GByteArray. |
Bytes |
A simple refcounted data type representing an immutable sequence of zero or more bytes from an unspecified origin. since: 2.32 |
Checksum |
An opaque structure representing a checksumming operation. since: 2.16 |
Cond |
The |
Data |
An opaque data structure that represents a keyed data list. |
Date |
Represents a day between January 1, Year 1 and a few thousand years in the future. None of its members should be accessed directly. |
DateTime |
An opaque structure that represents a date and time, including a time zone. since: 2.26 |
DebugKey |
Associates a string with a bit flag. Used in g_parse_debug_string(). |
Dir |
An opaque structure representing an opened directory. |
Error |
The |
HashTable |
The |
HashTableIter |
A GHashTableIter structure represents an iterator that can be used
to iterate over the elements of a |
Hmac |
An opaque structure representing a HMAC operation. To create a new GHmac, use g_hmac_new(). To free a GHmac, use g_hmac_unref(). since: 2.30 |
Hook |
The |
HookList |
The |
IConv |
The GIConv struct wraps an |
IOChannel |
A data structure representing an IO Channel. The fields should be considered private and should only be accessed with the following functions. |
IOFuncs |
A table of functions used to handle different types of |
KeyFile |
The GKeyFile struct contains only private data and should not be accessed directly. |
List |
The |
LogField |
Structure representing a single field in a structured log entry. See
since: 2.50 |
MainContext |
The |
MainLoop |
The |
MappedFile |
The |
MarkupParseContext |
A parse context is used to parse a stream of bytes that you expect to contain marked-up text. |
MarkupParser |
Any of the fields in |
MatchInfo |
A GMatchInfo is an opaque struct used to return information about matches. |
MemVTable |
A set of functions used to perform memory allocation. The same |
Node |
The |
Once |
A since: 2.4 |
OptionContext |
A |
OptionEntry |
A GOptionEntry struct defines a single option. To have an effect, they
must be added to a |
OptionGroup |
A |
PathBuf |
since: 2.76 |
PatternSpec |
A GPatternSpec struct is the ‘compiled’ form of a pattern. This structure is opaque and its fields cannot be accessed directly. |
PollFD |
Represents a file descriptor, which events to poll for, and which events occurred. |
Private |
The |
PtrArray |
Contains the public fields of a pointer array. |
Queue |
Contains the public fields of a [Queue][glib-Double-ended-Queues]. |
Rand |
The GRand struct is an opaque data structure. It should only be accessed through the g_rand_* functions. |
RecMutex |
The GRecMutex struct is an opaque data structure to represent a
recursive mutex. It is similar to a since: 2.32 |
Regex |
The g_regex_*() functions implement regular expression pattern matching using syntax and semantics similar to Perl regular expression. since: 2.14 |
RWLock |
The GRWLock struct is an opaque data structure to represent a
reader-writer lock. It is similar to a since: 2.32 |
Scanner |
The data structure representing a lexical scanner. |
ScannerConfig |
Specifies the |
Sequence |
The |
SequenceIter |
The |
SList |
The |
Source |
The |
SourceCallbackFuncs |
The |
SourceFuncs |
The |
StatBuf |
A type corresponding to the appropriate struct type for the |
String |
The GString struct contains the public fields of a GString. |
StringChunk |
An opaque data structure representing String Chunks. It should only be accessed by using the following functions. |
StrvBuilder |
since: 2.68 |
TestCase |
An opaque structure representing a test case. |
TestConfig | |
TestLogBuffer | |
TestLogMsg | |
TestSuite |
An opaque structure representing a test suite. |
Thread |
The |
ThreadPool |
The |
Timer |
Opaque datatype that records a start time. |
TimeVal |
Represents a precise time, with seconds and microseconds. deprecated: 2.62 |
TimeZone |
since: 2.26 |
TrashStack |
Each piece of memory that is pushed onto the stack is cast to a GTrashStack*. deprecated: 2.48 |
Tree |
The GTree struct is an opaque data structure representing a [balanced binary tree][glib-Balanced-Binary-Trees]. It should be accessed only by using the following functions. |
TreeNode |
An opaque type which identifies a specific node in a since: 2.68 |
Uri |
The since: 2.66 |
UriParamsIter |
Many URI schemes include one or more attribute/value pairs as part of the URI
value. For example since: 2.66 |
Variant |
since: 2.24 |
VariantBuilder |
A utility type for constructing container-type |
VariantDict |
since: 2.40 |
VariantIter |
|
VariantType |
This section introduces the GVariant type system. It is based, in large part, on the D-Bus type system, with two major changes and some minor lifting of restrictions. The D-Bus specification, therefore, provides a significant amount of information that is useful when working with GVariant. |
Unions
DoubleIEEE754 |
The |
FloatIEEE754 |
The |
Mutex |
The |
TokenValue |
A union holding the value of the token. |
Aliases
DateDay |
Integer representing a day of the month; between 1 and 31. |
DateYear |
Integer type representing a year. |
MainContextPusher |
Opaque type. See |
MutexLocker |
Opaque type. See |
Pid |
A type which is used to hold a process identification. |
Quark |
A GQuark is a non-zero integer which uniquely identifies a
particular string. A GQuark value of zero is associated to |
RecMutexLocker |
Opaque type. See |
RefString |
A typedef for a reference-counted string. A pointer to a |
RWLockReaderLocker |
Opaque type. See |
RWLockWriterLocker |
Opaque type. See |
Strv |
A typedef alias for gchar**. This is mostly useful when used together with g_auto(). |
Time |
Simply a replacement for deprecated: 2.62 |
TimeSpan |
A value representing an interval of time, in microseconds. |
Type |
Enumerations
ChecksumType |
The hashing algorithm to be used by since: 2.16 |
DateDMY |
This enumeration isn’t used in the API, but may be useful if you need to mark a number as a day, month, or year. |
DateMonth |
Enumeration representing a month; values are |
DateWeekday |
Enumeration representing a day of the week; |
ErrorType |
The possible errors, used in the |
IOError |
|
IOStatus |
Statuses returned by most of the |
LogWriterOutput |
Return values from since: 2.50 |
NormalizeMode |
Defines how a Unicode string is transformed in a 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. Unicode strings should generally be normalized before comparing them. |
OnceStatus |
The possible statuses of a one-time initialization function
controlled by a since: 2.4 |
OptionArg |
The |
SeekType |
An enumeration specifying the base position for a
|
SliceConfig | |
TestFileType |
The type of file to return the filename for, when used with g_test_build_filename(). since: 2.38 |
TestLogType | |
TestResult | |
TimeType |
Disambiguates a given time in two ways. |
TokenType |
The possible types of token returned from each
|
TraverseType |
Specifies the type of traversal performed by g_tree_traverse(),
|
UnicodeBreakType |
These are the possible line break classifications. |
UnicodeScript |
The |
UnicodeType |
These are the possible character classifications from the Unicode specification. See Unicode Character Database. |
UserDirectory |
These are logical ids for special directories which are defined
depending on the platform used. You should use since: 2.14 |
VariantClass |
The range of possible top-level types of since: 2.24 |
Bitfields
AsciiType | |
FileSetContentsFlags |
Flags to pass to since: 2.66 |
FileTest |
A test to perform on a file using g_file_test(). |
FormatSizeFlags |
Flags to modify the format of the string returned by g_format_size_full(). |
HookFlagMask |
Flags used internally in the |
IOCondition |
A bitwise combination representing a condition to watch for on an event source. |
IOFlags |
Specifies properties of a |
KeyFileFlags |
Flags which influence the parsing. |
LogLevelFlags |
Flags specifying the level of log messages. |
MainContextFlags |
Flags to pass to since: 2.72 |
MarkupCollectType |
A mixed enumerated type and flags field. You must specify one type
(string, strdup, boolean, tristate). Additionally, you may optionally
bitwise OR the type with the flag |
MarkupParseFlags |
Flags that affect the behaviour of the parser. |
OptionFlags |
Flags which modify individual options. |
RegexCompileFlags |
Flags specifying compile-time options. since: 2.14 |
RegexMatchFlags |
Flags specifying match-time options. since: 2.14 |
SpawnFlags |
Flags passed to g_spawn_sync(), |
TestSubprocessFlags |
Flags to pass to |
TestTrapFlags |
Test traps are guards around forked tests. These flags determine what traps to set. deprecated: 2.38 |
TraverseFlags |
Specifies which nodes are visited during several of the tree
functions, including |
UriFlags |
Flags that describe a URI. since: 2.66 |
UriHideFlags |
Flags describing what parts of the URI to hide in
g_uri_to_string_partial(). Note that since: 2.66 |
UriParamsFlags |
Flags modifying the way parameters are handled by since: 2.66 |
Error Domains
BookmarkFileError |
Error codes returned by bookmark file parsing. |
ConvertError |
Error codes returned by character set conversion routines. |
FileError |
Values corresponding to |
IOChannelError |
Error codes returned by |
KeyFileError |
Error codes returned by key file parsing. |
MarkupError |
Error codes returned by markup parsing. |
NumberParserError |
Error codes returned by functions converting a string to a number. since: 2.54 |
OptionError |
Error codes returned by option parsing. |
RegexError |
Error codes returned by regular expressions functions. since: 2.14 |
ShellError |
Error codes returned by shell functions. |
SpawnError |
Error codes returned by spawning processes. |
ThreadError |
Possible errors of thread related functions. |
UriError |
Error codes returned by since: 2.66 |
VariantParseError |
Error codes returned by parsing text-format GVariants. |
Callbacks
ChildWatchFunc |
Prototype of a |
ClearHandleFunc |
Specifies the type of function passed to g_clear_handle_id().
The implementation is expected to free the resource identified
by since: 2.56 |
CompareDataFunc |
Specifies the type of a comparison function used to compare two values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive integer if the first value comes after the second. |
CompareFunc |
Specifies the type of a comparison function used to compare two values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive integer if the first value comes after the second. |
CopyFunc |
A function of this signature is used to copy the node data when doing a deep-copy of a tree. since: 2.4 |
DataForeachFunc |
Specifies the type of function passed to g_dataset_foreach(). It is
called with each |
DestroyNotify |
Specifies the type of function which is called when a data element is destroyed. It is passed the pointer to the data element and should free any memory and resources allocated for it. |
DuplicateFunc |
The type of functions that are used to ‘duplicate’ an object.
What this means depends on the context, it could just be
incrementing the reference count, if |
EqualFunc |
Specifies the type of a function used to test two values for
equality. The function should return |
EqualFuncFull |
Specifies the type of a function used to test two values for
equality. The function should return since: 2.74 |
ErrorClearFunc |
Specifies the type of function which is called when an extended error instance is freed. It is passed the error pointer about to be freed, and should free the error’s private data fields. since: 2.68 |
ErrorCopyFunc |
Specifies the type of function which is called when an extended
error instance is copied. It is passed the pointer to the
destination error and source error, and should copy only the fields
of the private data from since: 2.68 |
ErrorInitFunc |
Specifies the type of function which is called just after an
extended error instance is created and its fields filled. It should
only initialize the fields in the private data, which can be
received with the generated since: 2.68 |
FreeFunc |
Declares a type of function which takes an arbitrary data pointer argument and has no return value. It is not currently used in GLib or GTK+. |
Func |
Specifies the type of functions passed to |
HashFunc |
Specifies the type of the hash function which is passed to
|
HFunc |
Specifies the type of the function passed to g_hash_table_foreach().
It is called with each key/value pair, together with the |
HookCheckFunc |
Defines the type of a hook function that can be invoked by g_hook_list_invoke_check(). |
HookCheckMarshaller |
Defines the type of function used by g_hook_list_marshal_check(). |
HookCompareFunc |
Defines the type of function used to compare |
HookFinalizeFunc |
Defines the type of function to be called when a hook in a list of hooks gets finalized. |
HookFindFunc |
Defines the type of the function passed to g_hook_find(). |
HookFunc |
Defines the type of a hook function that can be invoked by g_hook_list_invoke(). |
HookMarshaller |
Defines the type of function used by g_hook_list_marshal(). |
HRFunc |
Specifies the type of the function passed to
g_hash_table_foreach_remove(). It is called with each key/value
pair, together with the |
IOFunc |
Specifies the type of function passed to |
LogFunc |
Specifies the prototype of log handler functions. |
LogWriterFunc |
Writer function for log entries. A log entry is a collection of one or more
since: 2.50 |
NodeForeachFunc |
Specifies the type of function passed to g_node_children_foreach(). The function is called with each child node, together with the user data passed to g_node_children_foreach(). |
NodeTraverseFunc |
Specifies the type of function passed to g_node_traverse(). The
function is called with each of the nodes visited, together with the
user data passed to g_node_traverse(). If the function returns
|
OptionArgFunc |
The type of function to be passed as callback for |
OptionErrorFunc |
The type of function to be used as callback when a parse error occurs. |
OptionParseFunc |
The type of function that can be called before and after parsing. |
PollFunc |
Specifies the type of function passed to g_main_context_set_poll_func().
The semantics of the function should match those of the |
PrintFunc |
Specifies the type of the print handler functions. These are called with the complete formatted string to output. |
RegexEvalCallback |
Specifies the type of the function passed to g_regex_replace_eval().
It is called for each occurrence of the pattern in the string passed
to g_regex_replace_eval(), and it should append the replacement to
since: 2.14 |
ScannerMsgFunc |
Specifies the type of the message handler function. |
SequenceIterCompareFunc |
A |
SourceDisposeFunc |
Dispose function for since: 2.64 |
SourceDummyMarshal |
This is just a placeholder for |
SourceFunc |
Specifies the type of function passed to g_timeout_add(), g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). |
SourceOnceFunc |
A source function that is only called once before being removed from the main context automatically. since: 2.74 |
SpawnChildSetupFunc |
Specifies the type of the setup function passed to g_spawn_async(),
|
TestDataFunc |
The type used for test case functions that take an extra pointer argument. since: 2.28 |
TestFixtureFunc |
The type used for functions that operate on test fixtures. This is used for the fixture setup and teardown functions as well as for the testcases themselves. since: 2.28 |
TestFunc |
The type used for test case functions. since: 2.28 |
TestLogFatalFunc |
Specifies the prototype of fatal log handler functions. since: 2.22 |
ThreadFunc |
Specifies the type of the |
TranslateFunc |
The type of functions which are used to translate user-visible strings, for output. |
TraverseFunc |
Specifies the type of function passed to g_tree_traverse(). It is
passed the key and value of each node, together with the |
TraverseNodeFunc |
Specifies the type of function passed to g_tree_foreach_node(). It is
passed each node, together with the since: 2.68 |
UnixFDSourceFunc |
The type of functions to be called when a UNIX fd watch source triggers. |
VoidFunc |
Declares a type of function which takes no arguments and has no return value. It is used to specify the type function passed to g_atexit(). |
Functions
access |
A wrapper for the POSIX since: 2.8 |
aligned_alloc |
This function is similar to g_malloc(), allocating ( since: 2.72 |
aligned_alloc0 |
This function is similar to g_aligned_alloc(), but it will also clear the allocated memory before returning it. since: 2.72 |
aligned_free |
Frees the memory allocated by g_aligned_alloc(). since: 2.72 |
aligned_free_sized |
Frees the memory pointed to by since: 2.76 |
ascii_digit_value |
Determines the numeric value of a character as a decimal digit.
Differs from |
ascii_dtostr |
Converts a #gdouble to a string, using the ‘.’ as decimal point. |
ascii_formatd |
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’. |
ascii_strcasecmp |
Compare two strings, ignoring the case of ASCII characters. |
ascii_strdown |
Converts all upper case ASCII letters to lower case ASCII letters. |
ascii_string_to_signed |
A convenience function for converting a string to a signed number. since: 2.54 |
ascii_string_to_unsigned |
A convenience function for converting a string to an unsigned number. since: 2.54 |
ascii_strncasecmp |
Compare |
ascii_strtod |
Converts a string to a #gdouble value. |
ascii_strtoll |
Converts a string to a #gint64 value.
This function behaves like the standard since: 2.12 |
ascii_strtoull |
Converts a string to a #guint64 value.
This function behaves like the standard since: 2.2 |
ascii_strup |
Converts all lower case ASCII letters to upper case ASCII letters. |
ascii_tolower |
Convert a character to ASCII lower case. |
ascii_toupper |
Convert a character to ASCII upper case. |
ascii_xdigit_value |
Determines the numeric value of a character as a hexadecimal
digit. Differs from |
assert_warning | |
assertion_message | |
assertion_message_cmpnum | |
assertion_message_cmpstr | |
assertion_message_cmpstrv | |
assertion_message_error | |
assertion_message_expr |
Internal function used to print messages from the public |
atexit |
Specifies a function to be called at normal program termination. deprecated: 2.32 |
atomic_int_add |
Atomically adds since: 2.4 |
atomic_int_and |
Performs an atomic bitwise ‘and’ of the value of since: 2.30 |
atomic_int_compare_and_exchange |
Compares since: 2.4 |
atomic_int_compare_and_exchange_full |
Compares since: 2.74 |
atomic_int_dec_and_test |
Decrements the value of since: 2.4 |
atomic_int_exchange |
Sets the since: 2.74 |
atomic_int_exchange_and_add |
This function existed before deprecated: 2.30 since: 2.4 |
atomic_int_get |
Gets the current value of since: 2.4 |
atomic_int_inc |
Increments the value of since: 2.4 |
atomic_int_or |
Performs an atomic bitwise ‘or’ of the value of since: 2.30 |
atomic_int_set |
Sets the value of since: 2.4 |
atomic_int_xor |
Performs an atomic bitwise ‘xor’ of the value of since: 2.30 |
atomic_pointer_add |
Atomically adds since: 2.30 |
atomic_pointer_and |
Performs an atomic bitwise ‘and’ of the value of since: 2.30 |
atomic_pointer_compare_and_exchange |
Compares since: 2.4 |
atomic_pointer_compare_and_exchange_full |
Compares since: 2.74 |
atomic_pointer_exchange |
Sets the since: 2.74 |
atomic_pointer_get |
Gets the current value of since: 2.4 |
atomic_pointer_or |
Performs an atomic bitwise ‘or’ of the value of since: 2.30 |
atomic_pointer_set |
Sets the value of since: 2.4 |
atomic_pointer_xor |
Performs an atomic bitwise ‘xor’ of the value of since: 2.30 |
atomic_rc_box_acquire |
Atomically acquires a reference on the data pointed by since: 2.58 |
atomic_rc_box_alloc |
Allocates since: 2.58 |
atomic_rc_box_alloc0 |
Allocates since: 2.58 |
atomic_rc_box_dup |
Allocates a new block of data with atomic reference counting
semantics, and copies since: 2.58 |
atomic_rc_box_get_size |
Retrieves the size of the reference counted data pointed by since: 2.58 |
atomic_rc_box_release |
Atomically releases a reference on the data pointed by since: 2.58 |
atomic_rc_box_release_full |
Atomically releases a reference on the data pointed by since: 2.58 |
atomic_ref_count_compare |
Atomically compares the current value of since: 2.58 |
atomic_ref_count_dec |
Atomically decreases the reference count. since: 2.58 |
atomic_ref_count_inc |
Atomically increases the reference count. since: 2.58 |
atomic_ref_count_init |
Initializes a reference count variable to 1. since: 2.58 |
base64_decode |
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 |
base64_decode_inplace |
Decode a sequence of Base-64 encoded text into binary data by overwriting the input data. since: 2.20 |
base64_decode_step |
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 |
base64_encode |
Encode a sequence of binary data into its Base-64 stringified representation. since: 2.12 |
base64_encode_close |
Flush the status from a sequence of calls to g_base64_encode_step(). since: 2.12 |
base64_encode_step |
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 |
basename |
Gets the name of the file without any leading directory components. It returns a pointer into the given file name string. deprecated: 2.2 |
bit_lock |
Sets the indicated since: 2.24 |
bit_nth_lsf |
Find the position of the first bit set in |
bit_nth_msf |
Find the position of the first bit set in |
bit_storage |
Gets the number of bits used to hold |
bit_trylock |
Sets the indicated since: 2.24 |
bit_unlock |
Clears the indicated since: 2.24 |
build_filename |
Creates a filename from a series of elements using the correct separator for the current platform. |
build_filename_valist |
Creates a filename from a list of elements using the correct separator for the current platform. since: 2.56 |
build_filenamev |
Creates a filename from a vector of elements using the correct separator for the current platform. since: 2.8 |
build_path |
Creates a path from a series of elements using |
build_pathv |
Behaves exactly like g_build_path(), but takes the path elements as a string array, instead of variadic arguments. since: 2.8 |
canonicalize_filename |
Gets the canonical file name from since: 2.58 |
chdir |
A wrapper for the POSIX since: 2.8 |
check_version |
Checks that the GLib library in use is compatible with the given version. since: 2.6 |
child_watch_add |
Sets a function to be called when the child indicated by since: 2.4 |
child_watch_add_full |
Sets a function to be called when the child indicated by since: 2.4 |
child_watch_source_new |
Creates a new child_watch source. since: 2.4 |
clear_error |
If |
clear_handle_id |
Clears a numeric handler, such as a since: 2.56 |
clear_list |
Clears a pointer to a since: 2.64 |
clear_pointer |
Clears a reference to a variable. since: 2.34 |
clear_slist |
Clears a pointer to a since: 2.64 |
close |
This wraps the since: 2.36 |
compute_checksum_for_bytes |
Computes the checksum for a binary since: 2.34 |
compute_checksum_for_data |
Computes the checksum for a binary since: 2.16 |
compute_checksum_for_string |
Computes the checksum of a string. since: 2.16 |
compute_hmac_for_bytes |
Computes the HMAC for a binary since: 2.50 |
compute_hmac_for_data |
Computes the HMAC for a binary since: 2.30 |
compute_hmac_for_string |
Computes the HMAC for a string. since: 2.30 |
convert |
Converts a string from one character set to another. |
convert_error_quark | |
convert_with_fallback |
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 |
convert_with_iconv |
Converts a string from one character set to another. |
datalist_clear |
Frees all the data elements of the datalist. The data elements’ destroy functions are called if they have been set. |
datalist_foreach |
Calls the given function for each data element of the datalist. The
function is called with each data element’s |
datalist_get_data |
Gets a data element, using its string identifier. This is slower than
|
datalist_get_flags |
Gets flags values packed in together with the datalist. See g_datalist_set_flags(). since: 2.8 |
datalist_id_dup_data |
This is a variant of since: 2.34 |
datalist_id_get_data |
Retrieves the data element corresponding to |
datalist_id_remove_multiple |
Removes multiple keys from a datalist. since: 2.74 |
datalist_id_remove_no_notify |
Removes an element, without calling its destroy notification function. |
datalist_id_replace_data |
Compares the member that is associated with since: 2.34 |
datalist_id_set_data_full |
Sets the data corresponding to the given |
datalist_init |
Resets the datalist to |
datalist_set_flags |
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 since: 2.8 |
datalist_unset_flags |
Turns off flag values for a data list. See since: 2.8 |
dataset_destroy |
Destroys the dataset, freeing all memory allocated, and calling any destroy functions set for data elements. |
dataset_foreach |
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_id_get_data |
Gets the data element corresponding to a |
dataset_id_remove_no_notify |
Removes an element, without calling its destroy notification function. |
dataset_id_set_data_full |
Sets the data element associated with the given |
dcgettext |
This is a variant of since: 2.26 |
dgettext |
This function is a wrapper of since: 2.18 |
direct_equal |
Compares two #gpointer arguments and returns |
direct_hash |
Converts a gpointer to a hash value.
It can be passed to |
dngettext |
This function is a wrapper of since: 2.18 |
double_equal |
Compares the two #gdouble values being pointed to and returns
since: 2.22 |
double_hash |
Converts a pointer to a #gdouble to a hash value.
It can be passed to since: 2.22 |
dpgettext |
This function is a variant of since: 2.16 |
dpgettext2 |
This function is a variant of since: 2.18 |
environ_getenv |
Returns the value of the environment variable since: 2.32 |
environ_setenv |
Sets the environment variable since: 2.32 |
environ_unsetenv |
Removes the environment variable since: 2.32 |
file_error_from_errno |
Gets a |
file_error_quark | |
file_get_contents |
Reads an entire file into allocated memory, with good error checking. |
file_open_tmp |
Opens a file for writing in the preferred directory for temporary files (as returned by g_get_tmp_dir()). |
file_read_link |
Reads the contents of the symbolic link since: 2.4 |
file_set_contents |
Writes all of since: 2.8 |
file_set_contents_full |
Writes all of since: 2.66 |
file_test |
Returns |
filename_display_basename |
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 |
filename_display_name |
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- since: 2.6 |
filename_from_uri |
Converts an escaped ASCII-encoded URI to a local filename in the encoding used for filenames. |
filename_from_utf8 |
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][setlocale]. |
filename_to_uri |
Converts an absolute filename to an escaped ASCII-encoded URI, with the path component following Section 3.3. of RFC 2396. |
filename_to_utf8 |
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][setlocale]. |
find_program_in_path |
Locates the first executable named On Windows, if |
format_size |
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 |
format_size_for_display |
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 |
format_size_full |
Formats a size. since: 2.30 |
fprintf |
An implementation of the standard since: 2.2 |
free |
Frees the memory pointed to by |
free_sized |
Frees the memory pointed to by since: 2.76 |
get_application_name |
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
since: 2.2 |
get_charset |
Obtains the character set for the [current locale][setlocale]; 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
|
get_codeset |
Gets the character set for the current locale. |
get_console_charset |
Obtains the character set used by the console attached to the process, which is suitable for printing output to the terminal. since: 2.62 |
get_current_dir |
Gets the current directory. |
get_current_time |
Equivalent to the UNIX deprecated: 2.62 |
get_environ |
Gets the list of environment variables for the current process. since: 2.28 |
get_filename_charsets |
Determines the preferred character sets used for filenames.
The first character set from the since: 2.6 |
get_home_dir |
Gets the current user’s home directory. |
get_host_name |
Return a name for the machine. since: 2.8 |
get_language_names |
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 |
get_language_names_with_category |
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 |
get_locale_variants |
Returns a list of derived variants of since: 2.28 |
get_monotonic_time |
Queries the system monotonic time. since: 2.28 |
get_num_processors |
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 since: 2.36 |
get_os_info |
Get information about the operating system. since: 2.64 |
get_prgname |
Gets the name of the program. This name should not be localized, in contrast to g_get_application_name(). |
get_real_name |
Gets the real name of the user. This usually comes from the user’s
entry in the |
get_real_time |
Queries the system wall-clock time. since: 2.28 |
get_system_config_dirs |
Returns an ordered list of base directories in which to access system-wide configuration information. since: 2.6 |
get_system_data_dirs |
Returns an ordered list of base directories in which to access system-wide application data. since: 2.6 |
get_tmp_dir |
Gets the directory to use for temporary files. |
get_user_cache_dir |
Returns a base directory in which to store non-essential, cached data specific to particular user. since: 2.6 |
get_user_config_dir |
Returns a base directory in which to store user-specific application configuration information such as user preferences and settings. since: 2.6 |
get_user_data_dir |
Returns a base directory in which to access application data such as icons that is customized for a particular user. since: 2.6 |
get_user_name |
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. |
get_user_runtime_dir |
Returns a directory that is unique to the current user on the local system. since: 2.28 |
get_user_special_dir |
Returns the full path of a special directory using its logical id. since: 2.14 |
get_user_state_dir |
Returns a base directory in which to store state files specific to particular user. since: 2.72 |
getenv |
Returns the value of an environment variable. |
hostname_is_ascii_encoded |
Tests if since: 2.22 |
hostname_is_ip_address |
Tests if since: 2.22 |
hostname_is_non_ascii |
Tests if since: 2.22 |
hostname_to_ascii |
Converts since: 2.22 |
hostname_to_unicode |
Converts since: 2.22 |
iconv |
Same as the standard UNIX routine iconv(), but may be implemented via libiconv on UNIX flavors that lack a native implementation. |
idle_add |
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, |
idle_add_full |
Adds a function to be called whenever there are no higher priority events pending. |
idle_add_once |
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, since: 2.74 |
idle_remove_by_data |
Removes the idle function with the given data. |
idle_source_new |
Creates a new idle source. |
int64_equal |
Compares the two #gint64 values being pointed to and returns
since: 2.22 |
int64_hash |
Converts a pointer to a #gint64 to a hash value. since: 2.22 |
int_equal |
Compares the two #gint values being pointed to and returns
|
int_hash |
Converts a pointer to a #gint to a hash value.
It can be passed to |
intern_static_string |
Returns a canonical representation for since: 2.10 |
intern_string |
Returns a canonical representation for since: 2.10 |
io_add_watch |
Adds the |
io_add_watch_full |
Adds the |
io_create_watch |
Creates a |
listenv |
Gets the names of all variables set in the environment. since: 2.8 |
locale_from_utf8 |
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][setlocale]. On Windows this means the system codepage. |
locale_to_utf8 |
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][setlocale] into a UTF-8 string. |
log |
Logs an error or debugging message. |
log_default_handler |
The default log handler set up by GLib; |
log_get_debug_enabled |
Return whether debug output from the GLib logging system is enabled. since: 2.72 |
log_remove_handler |
Removes the log handler. |
log_set_always_fatal |
Sets the message levels which are always fatal, in any log domain.
When a message with any of these levels is logged the program terminates.
You can only set the levels defined by GLib to be fatal.
|
log_set_debug_enabled |
Enable or disable debug output from the GLib logging system for all domains.
This value interacts disjunctively with since: 2.72 |
log_set_default_handler |
Installs a default log handler which is used if no
log handler has been set for the particular log domain
and log level combination. By default, GLib uses
since: 2.6 |
log_set_fatal_mask |
Sets the log levels which are fatal in the given domain.
|
log_set_handler |
Sets the log handler for a domain and a set of log levels. |
log_set_handler_full |
Like g_log_set_handler(), but takes a destroy notify for the since: 2.46 |
log_set_writer_func |
Set a writer function which will be called to format and write out each log message. Each program should set a writer function, or the default writer (g_log_writer_default()) will be used. since: 2.50 |
log_structured |
Log a message with structured data. since: 2.50 |
log_structured_array |
Log a message with structured data. The message will be passed through to the
log writer set by the application using g_log_set_writer_func(). If the
message is fatal (i.e. its log level is since: 2.50 |
log_structured_standard | |
log_variant |
Log a message with structured data, accepting the data within a since: 2.50 |
log_writer_default |
Format a structured log message and output it to the default log destination
for the platform. On Linux, this is typically the systemd journal, falling
back to since: 2.50 |
log_writer_default_set_use_stderr |
Configure whether the built-in log functions
(g_log_default_handler() for the old-style API, and both
since: 2.68 |
log_writer_default_would_drop |
Check whether since: 2.68 |
log_writer_format_fields |
Format a structured log message as a string suitable for outputting to the
terminal (or elsewhere). This will include the values of all fields it knows
how to interpret, which includes since: 2.50 |
log_writer_is_journald |
Check whether the given since: 2.50 |
log_writer_journald |
Format a structured log message and send it to the systemd journal as a set of key–value pairs. All fields are sent to the journal, but if a field has length zero (indicating program-specific data) then only its key will be sent. since: 2.50 |
log_writer_standard_streams |
Format a structured log message and print it to either since: 2.50 |
log_writer_supports_color |
Check whether the given since: 2.50 |
logv |
Logs an error or debugging message. |
main_current_source |
Returns the currently firing source for this thread. since: 2.12 |
main_depth |
Returns the depth of the stack of calls to
|
malloc |
Allocates |
malloc0 |
Allocates |
malloc0_n |
This function is similar to g_malloc0(), allocating ( since: 2.24 |
malloc_n |
This function is similar to g_malloc(), allocating ( since: 2.24 |
markup_collect_attributes |
Collects the attributes of the element from the data passed to the
since: 2.16 |
markup_error_quark | |
markup_escape_text |
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. |
markup_printf_escaped |
Formats arguments according to since: 2.4 |
markup_vprintf_escaped |
Formats the data in since: 2.4 |
mem_is_system_malloc |
Checks whether the allocator used by deprecated: 2.46 |
mem_profile |
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 |
mem_set_vtable |
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 |
memdup |
Allocates deprecated: 2.68 |
memdup2 |
Allocates since: 2.68 |
mkdir_with_parents |
Create a directory if it doesn’t already exist. Create intermediate parent directories as needed, too. since: 2.8 |
mkdtemp |
Creates a temporary directory. See the since: 2.30 |
mkdtemp_full |
Creates a temporary directory. See the since: 2.30 |
mkstemp |
Opens a temporary file. See the |
mkstemp_full |
Opens a temporary file. See the since: 2.22 |
nullify_pointer |
Set the pointer at the specified location to |
number_parser_error_quark | |
on_error_query |
Prompts the user with
|
on_error_stack_trace |
Invokes gdb, which attaches to the current process and shows a
stack trace. Called by |
option_error_quark | |
parse_debug_string |
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. |
path_get_basename |
Gets the last component of the filename. |
path_get_dirname |
Gets the directory components of a file name. For example, the directory
component of |
path_is_absolute |
Returns |
path_skip_root |
Returns a pointer into |
pattern_match |
Matches a string against a compiled pattern. Passing the correct
length of the string given is mandatory. The reversed string can be
omitted by passing deprecated: 2.70 |
pattern_match_simple |
Matches a string against a pattern given as a string. If this
function is to be called in a loop, it’s more efficient to compile
the pattern once with |
pattern_match_string |
Matches a string against a compiled pattern. If the string is to be
matched against more than one pattern, consider using
deprecated: 2.70 |
pointer_bit_lock |
This is equivalent to g_bit_lock, but working on pointers (or other pointer-sized values). since: 2.30 |
pointer_bit_trylock |
This is equivalent to g_bit_trylock(), but working on pointers (or other pointer-sized values). since: 2.30 |
pointer_bit_unlock |
This is equivalent to g_bit_unlock, but working on pointers (or other pointer-sized values). since: 2.30 |
poll |
Polls since: 2.20 |
prefix_error |
Formats a string according to since: 2.16 |
prefix_error_literal |
Prefixes since: 2.70 |
Outputs a formatted message via the print handler.
The default print handler outputs the encoded message to stdout, without
appending a trailing new-line character. Typically, |
|
printerr |
Outputs a formatted message via the error message handler.
The default handler outputs the encoded message to stderr, without appending
a trailing new-line character. Typically, |
printf |
An implementation of the standard since: 2.2 |
printf_string_upper_bound |
Calculates the maximum space needed to store the output
of the |
propagate_error |
If |
propagate_prefixed_error |
If since: 2.16 |
qsort_with_data |
This is just like the standard C |
quark_from_static_string |
Gets the |
quark_from_string |
Gets the |
quark_to_string |
Gets the string associated with the given |
quark_try_string |
Gets the |
random_double |
Returns a random #gdouble equally distributed over the range [0..1). |
random_double_range |
Returns a random #gdouble equally distributed over the range
[ |
random_int |
Return a random #guint32 equally distributed over the range [0..2^32-1]. |
random_int_range |
Returns a random #gint32 equally distributed over the range
[ |
random_set_seed |
Sets the seed for the global random number generator, which is used
by the g_random_* functions, to |
rc_box_acquire |
Acquires a reference on the data pointed by since: 2.58 |
rc_box_alloc |
Allocates since: 2.58 |
rc_box_alloc0 |
Allocates since: 2.58 |
rc_box_dup |
Allocates a new block of data with reference counting
semantics, and copies since: 2.58 |
rc_box_get_size |
Retrieves the size of the reference counted data pointed by since: 2.58 |
rc_box_release |
Releases a reference on the data pointed by since: 2.58 |
rc_box_release_full |
Releases a reference on the data pointed by since: 2.58 |
realloc |
Reallocates the memory pointed to by |
realloc_n |
This function is similar to g_realloc(), allocating ( since: 2.24 |
ref_count_compare |
Compares the current value of since: 2.58 |
ref_count_dec |
Decreases the reference count. since: 2.58 |
ref_count_inc |
Increases the reference count. since: 2.58 |
ref_count_init |
Initializes a reference count variable to 1. since: 2.58 |
ref_string_acquire |
Acquires a reference on a string. since: 2.58 |
ref_string_length |
Retrieves the length of since: 2.58 |
ref_string_new |
Creates a new reference counted string and copies the contents of since: 2.58 |
ref_string_new_intern |
Creates a new reference counted string and copies the content of since: 2.58 |
ref_string_new_len |
Creates a new reference counted string and copies the contents of since: 2.58 |
ref_string_release |
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 |
reload_user_special_dirs_cache |
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 |
return_if_fail_warning |
Internal function used to print messages from the public |
rmdir |
A wrapper for the POSIX since: 2.6 |
set_application_name |
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.
since: 2.2 |
set_error |
Does nothing if |
set_error_literal |
Does nothing if since: 2.18 |
set_prgname |
Sets the name of the program. This name should not be localized, in contrast to g_set_application_name(). |
set_print_handler |
Sets the print handler to |
set_printerr_handler |
Sets the handler for printing error messages to |
setenv |
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 |
shell_error_quark | |
shell_parse_argv |
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). |
shell_quote |
Quotes a string so that the shell (/bin/sh) will interpret the
quoted string to mean |
shell_unquote |
Unquotes a string as the shell (/bin/sh) would. |
slice_alloc |
Allocates a block of memory from the libc allocator. since: 2.10 |
slice_alloc0 |
Allocates a block of memory via since: 2.10 |
slice_copy |
Allocates a block of memory from the slice allocator
and copies since: 2.14 |
slice_free1 |
Frees a block of memory. since: 2.10 |
slice_free_chain_with_offset |
Frees a linked list of memory blocks of structure type since: 2.10 |
slice_get_config | |
slice_get_config_state | |
slice_set_config | |
snprintf |
A safer form of the standard |
spaced_primes_closest |
Gets the smallest prime number from a built-in array of primes which
is larger than |
spawn_async |
Executes a child program asynchronously. |
spawn_async_with_fds |
Executes a child program asynchronously. since: 2.58 |
spawn_async_with_pipes |
Identical to |
spawn_async_with_pipes_and_fds |
Executes a child program asynchronously (your program will not block waiting for the child to exit). since: 2.68 |
spawn_check_exit_status |
An old name for g_spawn_check_wait_status(), deprecated because its name is misleading. deprecated: 2.70 since: 2.34 |
spawn_check_wait_status |
Set since: 2.70 |
spawn_close_pid |
On some platforms, notably Windows, the |
spawn_command_line_async |
A simple version of |
spawn_command_line_sync |
A simple version of |
spawn_error_quark | |
spawn_exit_error_quark | |
spawn_sync |
Executes a child synchronously (waits for the child to exit before returning). |
sprintf |
An implementation of the standard since: 2.2 |
stpcpy |
Copies a nul-terminated string into the destination buffer, including
the trailing nul byte, and returns a pointer to the trailing nul byte
in |
str_equal |
Compares two strings for byte-by-byte equality and returns |
str_has_prefix |
Looks whether the string since: 2.2 |
str_has_suffix |
Looks whether the string since: 2.2 |
str_hash |
Converts a string to a hash value. |
str_is_ascii |
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 |
str_match_string |
Checks if a search conducted for since: 2.40 |
str_to_ascii |
Transliterate since: 2.40 |
str_tokenize_and_fold |
Tokenises since: 2.40 |
strcanon |
For each character in |
strcasecmp |
A case-insensitive string comparison, corresponding to the standard
deprecated: 2.2 |
strchomp |
Removes trailing whitespace from a string. |
strchug |
Removes leading whitespace from a string, by moving the rest of the characters forward. |
strcmp0 |
Compares since: 2.16 |
strcompress |
Replaces all escaped characters with their one byte equivalent. |
strconcat |
Concatenates all of the given strings into one long string. The
returned string should be freed with |
strdelimit |
Converts any delimiter characters in |
strdown |
Converts a string to lower case. deprecated: 2.2 |
strdup |
Duplicates a string. If |
strdup_printf |
Similar to the standard C |
strdup_vprintf |
Similar to the standard C |
strdupv |
Copies |
strerror |
Returns a string corresponding to the given error code, e.g. “no such process”. Unlike strerror(), this always returns a string in UTF-8 encoding, and the pointer is guaranteed to remain valid for the lifetime of the process. |
strescape |
Escapes the special characters ‘\b’, ‘\f’, ‘\n’, ‘\r’, ‘\t’, ‘\v’, ‘'
and ‘”’ in the string |
strfreev |
Frees a |
strip_context |
An auxiliary function for since: 2.4 |
strjoin |
Joins a number of strings together to form one long string, with the
optional |
strjoinv |
Joins a number of strings together to form one long string, with the
optional |
strlcat |
Portability wrapper that calls |
strlcpy |
Portability wrapper that calls |
strncasecmp |
A case-insensitive string comparison, corresponding to the standard
deprecated: 2.2 |
strndup |
Duplicates the first |
strnfill |
Creates a new string |
strreverse |
Reverses all of the bytes in a string. For example,
|
strrstr |
Searches the string |
strrstr_len |
Searches the string |
strsignal |
Returns a string describing the given signal, e.g. “Segmentation fault”.
You should use this function in preference to strsignal(), because it
returns a string in UTF-8 encoding, and since not all platforms support
the |
strsplit |
Splits a string into a maximum of |
strsplit_set |
Splits since: 2.4 |
strstr_len |
Searches the string |
strtod |
Converts a string to a #gdouble value.
It calls the standard |
strup |
Converts a string to upper case. deprecated: 2.2 |
strv_contains |
Checks if since: 2.44 |
strv_equal |
Checks if since: 2.60 |
strv_get_type | |
strv_length |
Returns the length of the given since: 2.6 |
test_add_data_func |
Create a new test case, similar to g_test_create_case(). However
the test is assumed to use no fixture, and test suites are automatically
created on the fly and added to the root fixture, based on the
slash-separated portions of since: 2.16 |
test_add_data_func_full |
Create a new test case, as with g_test_add_data_func(), but freeing
since: 2.34 |
test_add_func |
Create a new test case, similar to g_test_create_case(). However
the test is assumed to use no fixture, and test suites are automatically
created on the fly and added to the root fixture, based on the
slash-separated portions of since: 2.16 |
test_add_vtable | |
test_bug |
This function adds a message to test reports that associates a bug URI with a test case. since: 2.16 |
test_bug_base |
Specify the base URI for bug reports. since: 2.16 |
test_build_filename |
Creates the pathname to a data file that is required for a test. since: 2.38 |
test_create_case |
Create a new since: 2.16 |
test_create_suite |
Create a new test suite with the name since: 2.16 |
test_expect_message |
Indicates that a message with the given since: 2.34 |
test_fail |
Indicates that a test failed. This function can be called multiple times from the same test. You can use this function if your test failed in a recoverable way. since: 2.30 |
test_fail_printf |
Equivalent to g_test_fail(), but also record a message like g_test_skip_printf(). since: 2.70 |
test_failed |
Returns whether a test has already failed. This will
be the case when g_test_fail(), since: 2.38 |
test_get_dir |
Gets the pathname of the directory containing test files of the type
specified by since: 2.38 |
test_get_filename |
Gets the pathname to a data file that is required for a test. since: 2.38 |
test_get_path |
Gets the test path for the test currently being run. since: 2.68 |
test_get_root |
Get the toplevel test suite for the test path API. since: 2.16 |
test_incomplete |
Indicates that a test failed because of some incomplete functionality. This function can be called multiple times from the same test. since: 2.38 |
test_incomplete_printf |
Equivalent to g_test_incomplete(), but the explanation is formatted as if by g_strdup_printf(). since: 2.70 |
test_init |
Initialize the GLib testing framework, e.g. by seeding the
test random number generator, the name for since: 2.16 |
test_log_set_fatal_handler |
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 |
test_log_type_name | |
test_maximized_result |
Report the result of a performance or measurement test.
The test should generally strive to maximize the reported
quantities (larger values are better than smaller ones),
this and since: 2.16 |
test_message |
Add a message to the test report. since: 2.16 |
test_minimized_result |
Report the result of a performance or measurement test.
The test should generally strive to minimize the reported
quantities (smaller values are better than larger ones),
this and since: 2.16 |
test_queue_destroy |
This function enqueus a callback since: 2.16 |
test_queue_free |
Enqueue a pointer to be released with since: 2.16 |
test_rand_double |
Get a reproducible random floating point number,
see since: 2.16 |
test_rand_double_range |
Get a reproducible random floating pointer number out of a specified range,
see since: 2.16 |
test_rand_int |
Get a reproducible random integer number. since: 2.16 |
test_rand_int_range |
Get a reproducible random integer number out of a specified range,
see since: 2.16 |
test_run |
Runs all tests under the toplevel suite which can be retrieved
with g_test_get_root(). Similar to g_test_run_suite(), the test
cases to be run are filtered according to test path arguments
( since: 2.16 |
test_run_suite |
Execute the tests within since: 2.16 |
test_set_nonfatal_assertions |
Changes the behaviour of the various since: 2.38 |
test_skip |
Indicates that a test was skipped. since: 2.38 |
test_skip_printf |
Equivalent to g_test_skip(), but the explanation is formatted as if by g_strdup_printf(). since: 2.70 |
test_subprocess |
Returns since: 2.38 |
test_summary |
Set the summary for a test, which describes what the test checks, and how it goes about checking it. This may be included in test report output, and is useful documentation for anyone reading the source code or modifying a test in future. It must be a single line. since: 2.62 |
test_timer_elapsed |
Get the number of seconds since the last start of the timer with g_test_timer_start(). since: 2.16 |
test_timer_last |
Report the last result of g_test_timer_elapsed(). since: 2.16 |
test_timer_start |
Start a timing test. Call since: 2.16 |
test_trap_assertions | |
test_trap_fork |
Fork the current test program to execute a test case that might not return or that might abort. deprecated: Unknown since: 2.16 |
test_trap_has_passed |
Check the result of the last since: 2.16 |
test_trap_reached_timeout |
Check the result of the last since: 2.16 |
test_trap_subprocess |
Respawns the test program to run only since: 2.38 |
timeout_add |
Sets a function to be called at regular intervals, with the default
priority, |
timeout_add_full |
Sets a function to be called at regular intervals, with the given
priority. The function is called repeatedly until it returns
|
timeout_add_once |
Sets a function to be called after since: 2.74 |
timeout_add_seconds |
Sets a function to be called at regular intervals with the default
priority, since: 2.14 |
timeout_add_seconds_full |
Sets a function to be called at regular intervals, with since: 2.14 |
timeout_source_new |
Creates a new timeout source. |
timeout_source_new_seconds |
Creates a new timeout source. since: 2.14 |
try_malloc |
Attempts to allocate |
try_malloc0 |
Attempts to allocate since: 2.8 |
try_malloc0_n |
This function is similar to g_try_malloc0(), allocating ( since: 2.24 |
try_malloc_n |
This function is similar to g_try_malloc(), allocating ( since: 2.24 |
try_realloc |
Attempts to realloc |
try_realloc_n |
This function is similar to g_try_realloc(), allocating ( since: 2.24 |
ucs4_to_utf16 |
Convert a string from UCS-4 to UTF-16. A 0 character will be added to the result after the converted text. |
ucs4_to_utf8 |
Convert a string from a 32-bit fixed width representation as UCS-4. to UTF-8. The result will be terminated with a 0 byte. |
unichar_break_type |
Determines the break type of |
unichar_combining_class |
Determines the canonical combining class of a Unicode character. since: 2.14 |
unichar_compose |
Performs a single composition step of the Unicode canonical composition algorithm. since: 2.30 |
unichar_decompose |
Performs a single decomposition step of the Unicode canonical decomposition algorithm. since: 2.30 |
unichar_digit_value |
Determines the numeric value of a character as a decimal digit. |
unichar_fully_decompose |
Computes the canonical or compatibility decomposition of a
Unicode character. For compatibility decomposition,
pass since: 2.30 |
unichar_get_mirror_char |
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 |
unichar_get_script |
Looks up the since: 2.14 |
unichar_isalnum |
Determines whether a character is alphanumeric. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). |
unichar_isalpha |
Determines whether a character is alphabetic (i.e. a letter). Given some UTF-8 text, obtain a character value with g_utf8_get_char(). |
unichar_iscntrl |
Determines whether a character is a control character. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). |
unichar_isdefined |
Determines if a given character is assigned in the Unicode standard. |
unichar_isdigit |
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(). |
unichar_isgraph |
Determines whether a character is printable and not a space
(returns |
unichar_islower |
Determines whether a character is a lowercase letter. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). |
unichar_ismark |
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 |
unichar_isprint |
Determines whether a character is printable.
Unlike g_unichar_isgraph(), returns |
unichar_ispunct |
Determines whether a character is punctuation or a symbol. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). |
unichar_isspace |
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(). |
unichar_istitle |
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. |
unichar_isupper |
Determines if a character is uppercase. |
unichar_iswide |
Determines if a character is typically rendered in a double-width cell. |
unichar_iswide_cjk |
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 |
unichar_isxdigit |
Determines if a character is a hexadecimal digit. |
unichar_iszerowidth |
Determines if a given character typically takes zero width when rendered.
The return value is since: 2.14 |
unichar_to_utf8 |
Converts a single character to UTF-8. |
unichar_tolower |
Converts a character to lower case. |
unichar_totitle |
Converts a character to the titlecase. |
unichar_toupper |
Converts a character to uppercase. |
unichar_type |
Classifies a Unicode character by type. |
unichar_validate |
Checks whether |
unichar_xdigit_value |
Determines the numeric value of a character as a hexadecimal digit. |
unicode_canonical_decomposition |
Computes the canonical decomposition of a Unicode character. deprecated: 2.30 |
unicode_canonical_ordering |
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. |
unicode_script_from_iso15924 |
Looks up the Unicode script for since: 2.30 |
unicode_script_to_iso15924 |
Looks up the ISO 15924 code for since: 2.30 |
unix_error_quark | |
unix_fd_add |
Sets a function to be called when the IO condition, as specified by
since: 2.36 |
unix_fd_add_full |
Sets a function to be called when the IO condition, as specified by
since: 2.36 |
unix_fd_source_new |
Creates a since: 2.36 |
unix_get_passwd_entry |
Get the since: 2.64 |
unix_open_pipe |
Similar to the UNIX since: 2.30 |
unix_set_fd_nonblocking |
Control the non-blocking state of the given file descriptor,
according to since: 2.30 |
unix_signal_add |
A convenience function for g_unix_signal_source_new(), which
attaches to the default since: 2.30 |
unix_signal_add_full |
A convenience function for g_unix_signal_source_new(), which
attaches to the default since: 2.30 |
unix_signal_source_new |
Create a since: 2.30 |
unlink |
A wrapper for the POSIX since: 2.6 |
unsetenv |
Removes an environment variable from the environment. since: 2.4 |
usleep |
Pauses the current thread for the given number of microseconds. |
utf16_to_ucs4 |
Convert a string from UTF-16 to UCS-4. The result will be nul-terminated. |
utf16_to_utf8 |
Convert a string from UTF-16 to UTF-8. The result will be terminated with a 0 byte. |
utf8_casefold |
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
|
utf8_collate |
Compares two strings for ordering using the linguistically
correct rules for the [current locale][setlocale].
When sorting a large number of strings, it will be significantly
faster to obtain collation keys with |
utf8_collate_key |
Converts a string into a collation key that can be compared with other collation keys produced by the same function using strcmp(). |
utf8_collate_key_for_filename |
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 |
utf8_find_next_char |
Finds the start of the next UTF-8 character in the string after |
utf8_find_prev_char |
Given a position |
utf8_get_char |
Converts a sequence of bytes encoded as UTF-8 to a Unicode character. |
utf8_get_char_validated |
Convert a sequence of bytes encoded as UTF-8 to a Unicode character. This function checks for incomplete characters, for invalid characters such as characters that are out of the range of Unicode, and for overlong encodings of valid characters. |
utf8_make_valid |
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 |
utf8_normalize |
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 |
utf8_offset_to_pointer |
Converts from an integer character offset to a pointer to a position within the string. |
utf8_pointer_to_offset |
Converts from a pointer to position within a string to an integer character offset. |
utf8_prev_char |
Finds the previous UTF-8 character in the string before |
utf8_strchr |
Finds the leftmost occurrence of the given Unicode character
in a UTF-8 encoded string, while limiting the search to |
utf8_strdown |
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. |
utf8_strlen |
Computes the length of the string in characters, not including
the terminating nul character. If the |
utf8_strncpy |
Like the standard C |
utf8_strrchr |
Find the rightmost occurrence of the given Unicode character
in a UTF-8 encoded string, while limiting the search to |
utf8_strreverse |
Reverses a UTF-8 string. since: 2.2 |
utf8_strup |
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.) |
utf8_substring |
Copies a substring out of a UTF-8 encoded string.
The substring will contain since: 2.30 |
utf8_to_ucs4 |
Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. A trailing 0 character will be added to the string after the converted text. |
utf8_to_ucs4_fast |
Convert a string from UTF-8 to a 32-bit fixed width
representation as UCS-4, assuming valid UTF-8 input.
This function is roughly twice as fast as |
utf8_to_utf16 |
Convert a string from UTF-8 to UTF-16. A 0 character will be added to the result after the converted text. |
utf8_validate |
Validates UTF-8 encoded text. |
utf8_validate_len |
Validates UTF-8 encoded text. since: 2.60 |
uuid_string_is_valid |
Parses the string since: 2.52 |
uuid_string_random |
Generates a random UUID (RFC 4122 version 4) as a string. It has the same
randomness guarantees as since: 2.52 |
variant_get_gtype | |
vasprintf |
An implementation of the GNU since: 2.4 |
vfprintf |
An implementation of the standard since: 2.2 |
vprintf |
An implementation of the standard since: 2.2 |
vsnprintf |
A safer form of the standard |
vsprintf |
An implementation of the standard since: 2.2 |
warn_message |
Internal function used to print messages from the public |
Function Macros
abort |
A wrapper for the POSIX since: 2.50 |
ALIGNOF |
Return the minimal alignment required by the platform ABI for values of the given
type. The address of a variable or struct member of the given type must always be
a multiple of this alignment. For example, most platforms require int variables
to be aligned at a 4-byte boundary, so since: 2.60 |
alloca |
Allocates |
alloca0 |
Wraps since: 2.72 |
APPROX_VALUE |
Evaluates to a truth value if the absolute difference between since: 2.58 |
array_append_val |
Adds the value on to the end of the array. The array will grow in size automatically if necessary. |
array_index |
Returns the element of a |
array_insert_val |
Inserts an element into an array at the given index. |
array_prepend_val |
Adds the value on to the start of the array. The array will grow in size automatically if necessary. |
ascii_isalnum |
Determines whether a character is alphanumeric. |
ascii_isalpha |
Determines whether a character is alphabetic (i.e. a letter). |
ascii_iscntrl |
Determines whether a character is a control character. |
ascii_isdigit |
Determines whether a character is digit (0-9). |
ascii_isgraph |
Determines whether a character is a printing character and not a space. |
ascii_islower |
Determines whether a character is an ASCII lower case letter. |
ascii_isprint |
Determines whether a character is a printing character. |
ascii_ispunct |
Determines whether a character is a punctuation character. |
ascii_isspace |
Determines whether a character is a white-space character. |
ascii_isupper |
Determines whether a character is an ASCII upper case letter. |
ascii_isxdigit |
Determines whether a character is a hexadecimal-digit character. |
assert |
Debugging macro to terminate the application if the assertion fails. If the assertion fails (i.e. the expression is not true), an error message is logged and the application is terminated. |
assert_cmpfloat |
Debugging macro to compare two floating point numbers. since: 2.16 |
assert_cmpfloat_with_epsilon |
Debugging macro to compare two floating point numbers within an epsilon. since: 2.58 |
assert_cmphex |
Debugging macro to compare to unsigned integers. since: 2.16 |
assert_cmpint |
Debugging macro to compare two integers. since: 2.16 |
assert_cmpmem |
Debugging macro to compare memory regions. If the comparison fails, an error message is logged and the application is either terminated or the testcase marked as failed. since: 2.46 |
assert_cmpstr |
Debugging macro to compare two strings. If the comparison fails, an error message is logged and the application is either terminated or the testcase marked as failed. The strings are compared using g_strcmp0(). since: 2.16 |
assert_cmpstrv |
Debugging macro to check if two since: 2.68 |
assert_cmpuint |
Debugging macro to compare two unsigned integers. since: 2.16 |
assert_cmpvariant |
Debugging macro to compare two since: 2.60 |
assert_error |
Debugging macro to check that a method has returned
the correct since: 2.20 |
assert_false |
Debugging macro to check an expression is false. since: 2.38 |
assert_no_errno |
Debugging macro to check that an expression has a non-negative return value,
as used by traditional POSIX functions (such as since: 2.66 |
assert_no_error |
Debugging macro to check that a since: 2.20 |
assert_nonnull |
Debugging macro to check an expression is not since: 2.40 |
assert_not_reached |
Debugging macro to terminate the application if it is ever reached. If it is reached, an error message is logged and the application is terminated. |
assert_null |
Debugging macro to check an expression is since: 2.38 |
assert_true |
Debugging macro to check that an expression is true. since: 2.38 |
ATEXIT | |
atomic_rc_box_new |
A convenience macro to allocate atomically reference counted
data with the size of the given since: 2.58 |
atomic_rc_box_new0 |
A convenience macro to allocate atomically reference counted
data with the size of the given since: 2.58 |
BREAKPOINT |
Inserts a breakpoint instruction into the code. |
C_STD_CHECK_VERSION |
Macro to check if the current compiler supports a specified since: 2.76 |
CHECK_VERSION |
Checks whether the version of the GLib library that is being compiled against is greater than or equal to the given one. |
critical |
Logs a “critical warning” ( |
CXX_STD_CHECK_VERSION |
Macro to check if the current compiler supports a specified since: 2.76 |
datalist_id_remove_data |
Removes an element, using its |
datalist_id_set_data |
Sets the data corresponding to the given |
datalist_remove_data |
Removes an element using its string identifier. The data element’s destroy function is called if it has been set. |
datalist_remove_no_notify |
Removes an element, without calling its destroy notifier. |
datalist_set_data |
Sets the data element corresponding to the given string identifier. |
datalist_set_data_full |
Sets the data element corresponding to the given string identifier, and the function to be called when the data element is removed. |
dataset_get_data |
Gets the data element corresponding to a string. |
dataset_id_remove_data |
Removes a data element from a dataset. The data element’s destroy function is called if it has been set. |
dataset_id_set_data |
Sets the data element associated with the given |
dataset_remove_data |
Removes a data element corresponding to a string. Its destroy function is called if it has been set. |
dataset_remove_no_notify |
Removes an element, without calling its destroy notifier. |
dataset_set_data |
Sets the data corresponding to the given string identifier. |
dataset_set_data_full |
Sets the data corresponding to the given string identifier, and the function to call when the data element is destroyed. |
debug |
A convenience function/macro to log a debug message. The message should typically not be translated to the user’s language. since: 2.6 |
DEBUG_HERE |
A convenience form of g_log_structured(), recommended to be added to
functions when debugging. It prints the current monotonic time and the code
location using since: 2.50 |
DEFINE_AUTO_CLEANUP_CLEAR_FUNC |
Defines the appropriate cleanup function for a type. since: 2.44 |
DEFINE_AUTO_CLEANUP_FREE_FUNC |
Defines the appropriate cleanup function for a type. since: 2.44 |
DEFINE_AUTOPTR_CLEANUP_FUNC |
Defines the appropriate cleanup function for a pointer type. since: 2.44 |
DEFINE_EXTENDED_ERROR |
A convenience macro which defines two functions. First, returning
the since: 2.68 |
DEFINE_QUARK |
A convenience macro which defines a function returning the
since: 2.34 |
DEPRECATED_ENUMERATOR_FOR | |
DEPRECATED_FOR | |
DEPRECATED_MACRO_FOR | |
DEPRECATED_TYPE_FOR | |
ENCODE_VERSION | |
error |
A convenience function/macro to log an error message. The message should typically not be translated to the user’s language. |
GINT64_CONSTANT |
This macro is used to insert 64-bit integer literals into the source code. |
GNUC_ALLOC_SIZE |
Expands to the GNU C since: 2.18 |
GNUC_ALLOC_SIZE2 |
Expands to the GNU C since: 2.18 |
GNUC_CHECK_VERSION |
Expands to a check for a compiler with GNUC defined and a version greater than or equal to the major and minor numbers provided. For example, the following would only match on compilers such as GCC 4.8 or newer. since: 2.42 |
GNUC_DEPRECATED_FOR |
Like since: 2.26 |
GNUC_FORMAT |
Expands to the GNU C |
GNUC_PRINTF |
Expands to the GNU C |
GNUC_SCANF |
Expands to the GNU C |
GNUC_STRFTIME |
Expands to the GNU C since: 2.60 |
GOFFSET_CONSTANT |
This macro is used to insert #goffset 64-bit integer literals into the source code. since: 2.20 |
GUINT64_CONSTANT |
This macro is used to insert 64-bit unsigned integer literals into the source code. since: 2.10 |
hash_table_freeze |
This function is deprecated and will be removed in the next major release of GLib. It does nothing. |
hash_table_thaw |
This function is deprecated and will be removed in the next major release of GLib. It does nothing. |
HOOK_ACTIVE |
Returns |
hook_append |
Appends a |
HOOK_FLAGS |
Gets the flags of a hook. |
HOOK_IN_CALL |
Returns |
htonl |
Converts a 32-bit integer value from host to network byte order. |
htons |
Converts a 16-bit integer value from host to network byte order. |
info |
A convenience function/macro to log an informational message. Seldom used. since: 2.40 |
LIKELY |
Hints the compiler that the expression is likely to evaluate to a true value. The compiler may use this information for optimizations. since: 2.2 |
list_next |
A convenience macro to get the next element in a |
list_previous |
A convenience macro to get the previous element in a |
LOCK |
Works like g_mutex_lock(), but for a lock defined with
|
LOCK_DEFINE |
The |
LOCK_DEFINE_STATIC |
This works like |
LOCK_EXTERN |
This declares a lock, that is defined with |
LOCK_NAME | |
memmove |
Copies a block of memory deprecated: 2.40 |
message |
A convenience function/macro to log a normal message. |
N_ELEMENTS |
Determines the number of elements in an array. The array must be declared so the compiler knows its size at compile-time; this macro will not work on an array allocated on the heap, only static arrays or arrays on the stack. |
new |
Allocates |
new0 |
Allocates |
newa |
Wraps |
newa0 |
Wraps since: 2.72 |
node_append |
Inserts a |
node_append_data |
Inserts a new |
node_first_child |
Gets the first child of a |
node_insert_data |
Inserts a new |
node_insert_data_after |
Inserts a new |
node_insert_data_before |
Inserts a new |
node_next_sibling |
Gets the next sibling of a |
node_prepend_data |
Inserts a new |
node_prev_sibling |
Gets the previous sibling of a |
ntohl |
Converts a 32-bit integer value from network to host byte order. |
ntohs |
Converts a 16-bit integer value from network to host byte order. |
once |
The first call to this routine by a process with a given since: 2.4 |
PRIVATE_INIT |
A macro to assist with the static initialisation of a since: 2.32 |
ptr_array_index |
Returns the pointer at the given index of the pointer array. |
rand_boolean |
Returns a random #gboolean from |
random_boolean |
Returns a random #gboolean. This corresponds to an unbiased coin toss. |
rc_box_new |
A convenience macro to allocate reference counted data with
the size of the given since: 2.58 |
rc_box_new0 |
A convenience macro to allocate reference counted data with
the size of the given since: 2.58 |
renew |
Reallocates the memory pointed to by |
return_if_fail | |
return_if_reached | |
return_val_if_fail | |
return_val_if_reached | |
scanner_add_symbol |
Adds a symbol to the default scope. deprecated: 2.2 |
scanner_foreach_symbol |
Calls a function for each symbol in the default scope. deprecated: 2.2 |
scanner_freeze_symbol_table |
There is no reason to use this macro, since it does nothing. deprecated: 2.2 |
scanner_remove_symbol |
Removes a symbol from the default scope. deprecated: 2.2 |
scanner_thaw_symbol_table |
There is no reason to use this macro, since it does nothing. deprecated: 2.2 |
size_checked_add |
Performs a checked addition of since: 2.48 |
size_checked_mul |
Performs a checked multiplication of since: 2.48 |
SIZEOF_MEMBER |
Returns the size of since: 2.64 |
slice_dup |
A convenience macro to duplicate a block of memory using the slice allocator. since: 2.14 |
slice_free |
A convenience macro to free a block of memory that has been allocated from the slice allocator. since: 2.10 |
slice_free_chain |
Frees a linked list of memory blocks of structure type since: 2.10 |
slice_new |
A convenience macro to allocate a block of memory from the slice allocator. since: 2.10 |
slice_new0 |
A convenience macro to allocate a block of memory from the slice allocator and set the memory to 0. since: 2.10 |
slist_next |
A convenience macro to get the next element in a |
SOURCE_FUNC |
Cast a function pointer to a since: 2.58 |
steal_pointer |
Sets since: 2.44 |
STRINGIFY |
Accepts a macro or a string and converts it into a string after preprocessor argument expansion. For example, the following code: |
STRINGIFY_ARG | |
strstrip |
Removes leading and trailing whitespace from a string.
See |
STRUCT_MEMBER |
Returns a member of a structure at a given offset, using the given type. |
STRUCT_MEMBER_P |
Returns an untyped pointer to a given offset of a struct. |
STRUCT_OFFSET |
Returns the offset, in bytes, of a member of a struct. |
test_add |
Hook up a new test case at since: 2.16 |
test_assert_expected_messages |
Asserts that all messages previously indicated via
since: 2.34 |
test_initialized |
Returns since: 2.36 |
test_perf |
Returns |
test_queue_unref |
Enqueue an object to be released with since: 2.16 |
test_quick |
Returns |
test_quiet |
Returns |
test_rand_bit |
Get a reproducible random bit (0 or 1), see since: 2.16 |
test_slow |
Returns |
test_thorough |
Returns |
test_trap_assert_failed |
Assert that the last test subprocess failed. See g_test_trap_subprocess(). since: 2.16 |
test_trap_assert_passed |
Assert that the last test subprocess passed. See g_test_trap_subprocess(). since: 2.16 |
test_trap_assert_stderr |
Assert that the stderr output of the last test subprocess
matches since: 2.16 |
test_trap_assert_stderr_unmatched |
Assert that the stderr output of the last test subprocess
does not match since: 2.16 |
test_trap_assert_stdout |
Assert that the stdout output of the last test subprocess matches
since: 2.16 |
test_trap_assert_stdout_unmatched |
Assert that the stdout output of the last test subprocess
does not match since: 2.16 |
test_undefined |
Returns |
test_verbose |
Returns |
try_new |
Attempts to allocate since: 2.8 |
try_new0 |
Attempts to allocate since: 2.8 |
try_renew |
Attempts to reallocate the memory pointed to by since: 2.8 |
TRYLOCK |
Works like g_mutex_trylock(), but for a lock defined with
|
typeof | |
uint64_checked_add |
Performs a checked addition of since: 2.48 |
uint64_checked_mul |
Performs a checked multiplication of since: 2.48 |
uint_checked_add |
Performs a checked addition of since: 2.48 |
uint_checked_mul |
Performs a checked multiplication of since: 2.48 |
UNAVAILABLE | |
UNAVAILABLE_ENUMERATOR | |
UNAVAILABLE_MACRO | |
UNAVAILABLE_STATIC_INLINE | |
UNAVAILABLE_TYPE | |
UNLIKELY |
Hints the compiler that the expression is unlikely to evaluate to a true value. The compiler may use this information for optimizations. since: 2.2 |
UNLOCK |
Works like g_mutex_unlock(), but for a lock defined with
|
utf8_next_char |
Skips to the next character in a UTF-8 string. |
VARIANT_BUILDER_INIT |
A stack-allocated since: 2.50 |
VARIANT_DICT_INIT |
A stack-allocated since: 2.50 |
warn_if_fail |
Logs a warning if the expression is not true. since: 2.16 |
warn_if_reached |
Logs a warning. since: 2.16 |
warning |
A convenience function/macro to log a warning message. The message should typically not be translated to the user’s language. |
warning_once |
Logs a warning only once. since: 2.64 |
WIN32_DLLMAIN_FOR_DLL_NAME |
On Windows, this macro defines a DllMain() function that stores the actual DLL name that the code being compiled will be included in. |
WIN32_HAVE_WIDECHAR_API |
On Windows, this macro defines an expression which evaluates to
since: 2.6 |
Constants
ANALYZER_ANALYZING | |
ASCII_DTOSTR_BUF_SIZE |
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. |
BIG_ENDIAN |
Specifies one of the possible types of byte order.
See |
C_STD_VERSION |
The C standard version the code is compiling against, it’s normally
defined with the same value of |
CSET_A_2_Z |
The set of uppercase ASCII alphabet characters.
Used for specifying valid identifier characters
in |
CSET_a_2_z |
The set of lowercase ASCII alphabet characters.
Used for specifying valid identifier characters
in |
CSET_DIGITS |
The set of ASCII digits.
Used for specifying valid identifier characters
in |
DATALIST_FLAGS_MASK |
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. |
DATE_BAD_DAY |
Represents an invalid |
DATE_BAD_JULIAN |
Represents an invalid Julian day number. |
DATE_BAD_YEAR |
Represents an invalid year. |
DIR_SEPARATOR |
The directory separator character. This is ‘/’ on UNIX machines and ‘' under Windows. |
DIR_SEPARATOR_S |
The directory separator as a string. This is “/” on UNIX machines and “" under Windows. |
E |
The base of natural logarithms. |
GINT16_FORMAT |
This is the platform dependent conversion specifier for scanning and printing values of type #gint16. It is a string literal, but doesn’t include the percent-sign, such that you can add precision and length modifiers between percent-sign and conversion specifier. |
GINT16_MODIFIER |
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. |
GINT32_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #gint32. See also |
GINT32_MODIFIER |
The platform dependent length modifier for conversion specifiers
for scanning and printing values of type #gint32 or #guint32. It
is a string literal. See also |
GINT64_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #gint64. See also |
GINT64_MODIFIER |
The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gint64 or #guint64. It is a string literal. |
GINTPTR_FORMAT |
This is the platform dependent conversion specifier for scanning and printing values of type #gintptr. |
GINTPTR_MODIFIER |
The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gintptr or #guintptr. It is a string literal. |
GNUC_FUNCTION |
Expands to “” on all modern compilers, and to FUNCTION on gcc version 2.x. Don’t use it. deprecated: 2.16 |
GNUC_PRETTY_FUNCTION |
Expands to “” on all modern compilers, and to PRETTY_FUNCTION on gcc version 2.x. Don’t use it. deprecated: 2.16 |
GSIZE_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #gsize. See also |
GSIZE_MODIFIER |
The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gsize. It is a string literal. |
GSSIZE_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #gssize. See also |
GSSIZE_MODIFIER |
The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gssize. It is a string literal. |
GUINT16_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #guint16. See also |
GUINT32_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #guint32. See also |
GUINT64_FORMAT |
This is the platform dependent conversion specifier for scanning
and printing values of type #guint64. See also |
GUINTPTR_FORMAT |
This is the platform dependent conversion specifier for scanning and printing values of type #guintptr. |
HAVE_GINT64 | |
HAVE_GNUC_VARARGS | |
HAVE_GNUC_VISIBILITY |
Defined to 1 if gcc-style visibility handling is supported. |
HAVE_GROWING_STACK | |
HAVE_ISO_VARARGS | |
HOOK_FLAG_USER_SHIFT |
The position of the first bit which is not reserved for internal
use be the |
IEEE754_DOUBLE_BIAS |
The bias by which exponents in double-precision floats are offset. |
IEEE754_FLOAT_BIAS |
The bias by which exponents in single-precision floats are offset. |
KEY_FILE_DESKTOP_GROUP |
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. |
KEY_FILE_DESKTOP_KEY_ACTIONS |
A key under |
KEY_FILE_DESKTOP_KEY_CATEGORIES |
A key under |
KEY_FILE_DESKTOP_KEY_COMMENT |
A key under |
KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE |
A key under |
KEY_FILE_DESKTOP_KEY_EXEC |
A key under |
KEY_FILE_DESKTOP_KEY_GENERIC_NAME |
A key under |
KEY_FILE_DESKTOP_KEY_HIDDEN |
A key under |
KEY_FILE_DESKTOP_KEY_ICON |
A key under |
KEY_FILE_DESKTOP_KEY_MIME_TYPE |
A key under |
KEY_FILE_DESKTOP_KEY_NAME |
A key under |
KEY_FILE_DESKTOP_KEY_NO_DISPLAY |
A key under |
KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN |
A key under |
KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN |
A key under |
KEY_FILE_DESKTOP_KEY_PATH |
A key under |
KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY |
A key under |
KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS |
A key under |
KEY_FILE_DESKTOP_KEY_TERMINAL |
A key under |
KEY_FILE_DESKTOP_KEY_TRY_EXEC |
A key under |
KEY_FILE_DESKTOP_KEY_TYPE |
A key under |
KEY_FILE_DESKTOP_KEY_URL |
A key under |
KEY_FILE_DESKTOP_KEY_VERSION |
A key under |
KEY_FILE_DESKTOP_TYPE_APPLICATION |
The value of the |
KEY_FILE_DESKTOP_TYPE_DIRECTORY |
The value of the |
KEY_FILE_DESKTOP_TYPE_LINK |
The value of the |
LITTLE_ENDIAN |
Specifies one of the possible types of byte order.
See |
LN10 |
The natural logarithm of 10. |
LN2 |
The natural logarithm of 2. |
LOG_2_BASE_10 |
Multiplying the base 2 exponent by this number yields the base 10 exponent. |
LOG_DOMAIN |
Defines the log domain. See Log Domains. |
LOG_FATAL_MASK |
GLib log levels that are considered fatal by default. |
LOG_LEVEL_USER_SHIFT |
Log levels below 1<<G_LOG_LEVEL_USER_SHIFT are used by GLib. Higher bits can be used for user-defined log levels. |
MAJOR_VERSION |
The major version number of the GLib library. |
MAXINT16 |
The maximum value which can be held in a #gint16. |
MAXINT32 |
The maximum value which can be held in a #gint32. |
MAXINT64 |
The maximum value which can be held in a #gint64. |
MAXINT8 |
The maximum value which can be held in a #gint8. |
MAXUINT16 |
The maximum value which can be held in a #guint16. |
MAXUINT32 |
The maximum value which can be held in a #guint32. |
MAXUINT64 |
The maximum value which can be held in a #guint64. |
MAXUINT8 |
The maximum value which can be held in a #guint8. |
MICRO_VERSION |
The micro version number of the GLib library. |
MININT16 |
The minimum value which can be held in a #gint16. |
MININT32 |
The minimum value which can be held in a #gint32. |
MININT64 |
The minimum value which can be held in a #gint64. |
MININT8 |
The minimum value which can be held in a #gint8. |
MINOR_VERSION |
The minor version number of the GLib library. |
MODULE_SUFFIX | |
OPTION_REMAINING |
If a long option in the main group has this name, it is not treated as a
regular option. Instead it collects all non-option arguments which would
otherwise be left in |
PDP_ENDIAN |
Specifies one of the possible types of byte order
(currently unused). See |
PI |
The value of pi (ratio of circle’s circumference to its diameter). |
PI_2 |
Pi divided by 2. |
PI_4 |
Pi divided by 4. |
PID_FORMAT |
A format specifier that can be used in printf()-style format strings
when printing a |
POLLFD_FORMAT |
A format specifier that can be used in printf()-style format strings
when printing the |
PRIORITY_DEFAULT |
Use this for default priority event sources. |
PRIORITY_DEFAULT_IDLE |
Use this for default priority idle functions. |
PRIORITY_HIGH |
Use this for high priority event sources. |
PRIORITY_HIGH_IDLE |
Use this for high priority idle functions. |
PRIORITY_LOW |
Use this for very low priority background tasks. |
SEARCHPATH_SEPARATOR |
The search path separator character. This is ‘:’ on UNIX machines and ‘;’ under Windows. |
SEARCHPATH_SEPARATOR_S |
The search path separator as a string. This is “:” on UNIX machines and “;” under Windows. |
SIZEOF_LONG | |
SIZEOF_SIZE_T | |
SIZEOF_SSIZE_T | |
SIZEOF_VOID_P | |
SOURCE_CONTINUE |
Use this macro as the return value of a |
SOURCE_REMOVE |
Use this macro as the return value of a |
SQRT2 |
The square root of two. |
STR_DELIMITERS |
The standard delimiters, used in g_strdelimit(). |
SYSDEF_AF_INET | |
SYSDEF_AF_INET6 | |
SYSDEF_AF_UNIX | |
SYSDEF_MSG_DONTROUTE | |
SYSDEF_MSG_OOB | |
SYSDEF_MSG_PEEK | |
TEST_OPTION_ISOLATE_DIRS |
Creates a unique temporary directory for each unit test and uses
|
TIME_SPAN_DAY |
Evaluates to a time span of one day. |
TIME_SPAN_HOUR |
Evaluates to a time span of one hour. |
TIME_SPAN_MILLISECOND |
Evaluates to a time span of one millisecond. |
TIME_SPAN_MINUTE |
Evaluates to a time span of one minute. |
TIME_SPAN_SECOND |
Evaluates to a time span of one second. |
UNICHAR_MAX_DECOMPOSITION_LENGTH |
The maximum length (in codepoints) of a compatibility or canonical decomposition of a single Unicode character. |
URI_RESERVED_CHARS_GENERIC_DELIMITERS |
Generic delimiters characters as defined in
RFC 3986. Includes |
URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS |
Subcomponent delimiter characters as defined in
RFC 3986. Includes |
USEC_PER_SEC |
Number of microseconds in one second (1 million). This macro is provided for code readability. |
VA_COPY_AS_ARRAY | |
VERSION_MIN_REQUIRED |
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: |
WIN32_MSG_HANDLE |