Crate glib

Expand description

§Rust GLib and GObject bindings

Rust bindings and wrappers for GLib, part of gtk-rs-core.

GLib 2.56 is the lowest supported version for the underlying library.

This library contains bindings to GLib and GObject types and APIs as well as common building blocks used in both handmade and machine generated bindings to GTK and other GLib-based libraries.

It is the foundation for higher level libraries with uniform Rusty (safe and strongly typed) APIs. It avoids exposing GLib-specific data types where possible and is not meant to provide comprehensive GLib bindings, which would often amount to duplicating the Rust Standard Library or other utility crates.

§Minimum supported Rust version

Currently, the minimum supported Rust version is 1.70.0.

§Dynamic typing

Most types in the GLib family have Type identifiers. Their corresponding Rust types implement the StaticType trait.

A dynamically typed Value can carry values of any StaticType. Variants can carry values of StaticVariantType.

§Errors

Errors are represented by Error, which can carry values from various error domains such as FileError.

§Objects

Each class and interface has a corresponding smart pointer struct representing an instance of that type (e.g. Object for GObject or gtk4::Widget for GtkWidget). They are reference counted and feature interior mutability similarly to Rust’s Rc<RefCell<T>> idiom. Consequently, cloning objects is cheap and their methods never require mutable borrows. Two smart pointers are equal if they point to the same object.

The root of the object hierarchy is Object. Inheritance and subtyping is denoted with the IsA marker trait. The Cast trait enables upcasting and downcasting.

Interfaces and non-leaf classes also have corresponding traits (e.g. ObjectExt or WidgetExt), which are blanketly implemented for all their subtypes.

You can create new subclasses of Object or other object types. Look at the module’s documentation for further details and a code example.

§Under the hood

GLib-based libraries largely operate on pointers to various boxed or reference counted structures so the bindings have to implement corresponding smart pointers (wrappers), which encapsulate resource management and safety checks. Such wrappers are defined via the wrapper! macro, which uses abstractions defined in the wrapper, boxed, shared and object modules. The translate module defines and partly implements conversions between high level Rust types (including the aforementioned wrappers) and their FFI counterparts.

§Documentation

§Using

We recommend using crates from crates.io, as demonstrated here.

If you want to track the bleeding edge, use the git dependency instead:

[dependencies]
glib = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "glib" }

Avoid mixing versioned and git crates like this:

# This will not compile
[dependencies]
glib = "0.13"
glib = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "glib" }

§License

glib is available under the MIT License, please refer to it.

Re-exports§

pub use self::closure::Closure;
pub use self::closure::RustClosure;
pub use self::enums::EnumClass;
pub use self::enums::EnumValue;
pub use self::enums::FlagsBuilder;
pub use self::enums::FlagsClass;
pub use self::enums::FlagsValue;
pub use self::enums::UserDirectory;
pub use self::error::BoolError;
pub use self::error::Error;
pub use self::object::BorrowedObject;
pub use self::object::Class;
pub use self::object::InitiallyUnowned;
pub use self::object::Interface;
pub use self::object::Object;
pub use self::object::SendWeakRef;
pub use self::object::WeakRef;
pub use self::signal::signal_handler_block;
pub use self::signal::signal_handler_disconnect;
pub use self::signal::signal_handler_unblock;
pub use self::signal::signal_stop_emission_by_name;
pub use self::signal::Propagation;
pub use self::signal::SignalHandlerId;
pub use self::types::ILong;
pub use self::types::Pointer;
pub use self::types::Type;
pub use self::types::ULong;
pub use self::value::BoxedValue;
pub use self::value::SendValue;
pub use self::value::Value;
pub use self::variant::FixedSizeVariantArray;
pub use self::variant::Variant;
pub use self::FileError;
pub use collections::List;
pub use collections::PtrSlice;
pub use collections::SList;
pub use collections::Slice;
pub use collections::StrV;
pub use self::char::Char;
pub use self::char::UChar;
pub use self::match_info::MatchInfo;
pub use bitflags;
pub use glib_sys as ffi;
pub use gobject_sys as gobject_ffi;
pub use self::source::*;

Modules§

boxed: IMPL Boxed wrapper implementation.
boxed_inline: IMPL BoxedInline wrapper implementation.
char
clone
closure
collections
enums
error: Error binding and helper trait.
match_info
object: IMPL Object wrapper implementation and Object binding.
prelude: Traits and essential types intended for blanket imports.
property
regex: This module is inefficient and should not be used by Rust programs except for compatibility with GLib.Regex based APIs.
shared: IMPL Shared (reference counted) wrapper implementation.
signal: IMPL Low level signal support.
source
subclass: Module containing infrastructure for subclassing GObjects and registering boxed types.
thread_guard
translate: Translation between GLib/GLib-based FFI types and their Rust counterparts.
types: Runtime type information.
value: Value binding and helper traits.
variant: Variant binding and helper traits.
wrapper: IMPL The wrapper! macro and miscellaneous wrapper traits.

Macros§

bool_error: Generic error used for functions that fail without any further information
clone: Macro for passing variables as strong or weak references into a closure.
closure: Macro for creating a Closure object. This is a wrapper around Closure::new that automatically type checks its arguments at run-time.
closure_local: The same as closure! but uses Closure::new_local as a constructor. This is useful for closures which can’t be sent across threads. See the documentation of closure! for details.
debuglog and log_macros: A macro which behaves exactly as log::debug! except that it sets the current log target to the contents of a G_LOG_DOMAIN constant (and fails to build if not defined).
errorlog and log_macros: A macro which behaves exactly as log::error! except that it sets the current log target to the contents of a G_LOG_DOMAIN constant (and fails to build if not defined).
function_name: This macro returns the name of the enclosing function. As the internal implementation is based on the std::any::type_name, this macro derives all the limitations of this function.
g_critical: Macro used to log using GLib logging system. It uses g_log.
g_debug: Macro used to log using GLib logging system. It uses g_log.
g_error: Macro used to log using GLib logging system. It uses g_log.
g_info: Macro used to log using GLib logging system. It uses g_log.
g_log: Macro used to log using GLib logging system. It uses g_log.
g_message: Macro used to log using GLib logging system. It uses g_log.
g_print: Macro used to print messages. It uses g_print.
g_printerr: Macro used to print error messages. It uses g_printerr.
g_warning: Macro used to log using GLib logging system. It uses g_log.
gformat: Creates a GString using interpolation of runtime expressions.
glib_boxed_inline_wrapper: Wrapper implementations for BoxedInline types. See wrapper!.
glib_boxed_wrapper: Wrapper implementations for Boxed types. See wrapper!.
glib_object_wrapper: ObjectType implementations for Object types. See wrapper!.
glib_shared_wrapper: Wrapper implementations for shared types. See wrapper!.
gstr: Converts a static string literal into a static nul-terminated string.
infolog and log_macros: A macro which behaves exactly as log::info! except that it sets the current log target to the contents of a G_LOG_DOMAIN constant (and fails to build if not defined).
log_structured: Macro used to log using GLib structured logging system.
result_from_gboolean
tracelog and log_macros: A macro which behaves exactly as log::trace! except that it sets the current log target to the contents of a G_LOG_DOMAIN constant (and fails to build if not defined).
warnlog and log_macros: A macro which behaves exactly as log::warn! except that it sets the current log target to the contents of a G_LOG_DOMAIN constant (and fails to build if not defined).
wrapper: Defines a wrapper type and implements the appropriate traits.

Structs§

Binding: GObject instance (or source) and another property on another GObject instance (or target).
BindingFlags: Flags to be passed to ObjectExt::bind_property() or [ObjectExt::bind_property_full()][crate::prelude::ObjectExt::bind_property_full()].
BindingGroupv2_72: GBindingGroup can be used to bind multiple properties from an object collectively.
BindingGroupBuilderv2_72: Builder for binding group bindings.
BoxedAnyObject: This is a subclass of glib::object::Object capable of storing any Rust type. It let’s you insert a Rust type anywhere a glib::object::Object is needed. The inserted value can then be borrowed as a Rust type, by using the various provided methods.
ByteArray: Contains the public fields of a GByteArray. Contains the public fields of a GByteArray.
Bytes: A shared immutable byte slice (the equivalent of Rc<[u8]>).
Checksum: GLib provides a generic API for computing checksums (or ‘digests’) for a sequence of arbitrary bytes, using various hashing algorithms like MD5, SHA-1 and SHA-256. Checksums are commonly used in various environments and specifications.
CollationKey: A CollationKey allows ordering strings using the linguistically correct rules for the current locale.
Date: GLib type: Inline allocated boxed type with stack copy semantics.
DateTime: GDateTime is a structure that combines a Gregorian date and time into a single structure.
ExitCode
FileSetContentsFlagsv2_66: Flags to pass to g_file_set_contents_full() to affect its safety and performance.
FilenameCollationKey: A FilenameCollationKey allows ordering file names using the linguistically correct rules for the current locale. Compared to CollationKey, filename collation keys take into consideration dots and other characters commonly found in file names.
FormatSizeFlags: Flags to modify the format of the string returned by g_format_size_full().
FutureWithTimeoutError: The error returned when a future times out.
GStr: Representation of a borrowed GString.
GStrInteriorNulError: Error type indicating that a buffer had unexpected nul-bytes.
GString: A type representing an owned, C-compatible, nul-terminated UTF-8 string.
GStringBuilder: A mutable text buffer that grows automatically.
GStringInteriorNulError: Error type indicating that a buffer had unexpected nul-bytes.
GStringNoTrailingNulError: Error type indicating that a buffer did not have a trailing nul-byte.
GStringPtr: NULL-terminated UTF-8 string as stored in StrV.
GStringUtf8Error: Error type indicating that a buffer had invalid UTF-8.
GlibLoggerlog: An implementation of a log compatible logger which logs over glib logging facilities.
IConv: The GIConv struct wraps an iconv() conversion descriptor. It contains private data and should only be accessed using the following functions. The GIConv struct wraps an iconv() conversion descriptor. It contains private data and should only be accessed using the following functions.
IOCondition: A bitwise combination representing a condition to watch for on an event source.
InterfaceInfo: A structure that provides information to the type system which is used specifically for managing interface types. A structure that provides information to the type system which is used specifically for managing interface types.
JoinError: Task failure from awaiting a JoinHandle.
JoinHandle: A handle to a task running on a MainContext.
KeyFile: GKeyFile parses .ini-like config files.
KeyFileFlags: Flags which influence the parsing.
LogField: Structure representing a single field in a structured log entry.
LogHandlerId
LogLevelFlags: Flags specifying the level of log messages.
LogLevels
MainContext: The GMainContext struct is an opaque data type representing a set of sources to be handled in a main loop. The GMainContext struct is an opaque data type representing a set of sources to be handled in a main loop.
MainContextAcquireGuard
MainContextFlagsv2_72: Flags to pass to GLib::MainContext::new_with_flags() which affect the behaviour of a MainContext.
MainLoop: The GMainLoop struct is an opaque data type representing the main event loop of a GLib or GTK application. The GMainLoop struct is an opaque data type representing the main event loop of a GLib or GTK application.
MarkupParseContext: A parse context is used to parse a stream of bytes that you expect to contain marked-up text.
OptionFlags: Flags which modify individual options.
ParamFlags: Through the ParamFlags flag values, certain aspects of parameters can be configured.
ParamSpec: GParamSpec encapsulates the metadata required to specify parameters, such as GObject properties.
ParamSpecBoolean: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecBooleanBuilder
ParamSpecBoxed: A ParamSpec derived structure that contains the meta data for boxed properties.
ParamSpecBoxedBuilder
ParamSpecChar: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecCharBuilder
ParamSpecDouble: A ParamSpec derived structure that contains the meta data for double properties.
ParamSpecDoubleBuilder
ParamSpecEnum: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecEnumBuilder
ParamSpecFlags: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecFlagsBuilder
ParamSpecFloat: A ParamSpec derived structure that contains the meta data for float properties.
ParamSpecFloatBuilder
ParamSpecGType: A ParamSpec derived structure that contains the meta data for GType properties.
ParamSpecGTypeBuilder
ParamSpecInt: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecInt64: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecInt64Builder
ParamSpecIntBuilder
ParamSpecLong: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecLongBuilder
ParamSpecObject: A ParamSpec derived structure that contains the meta data for object properties.
ParamSpecObjectBuilder
ParamSpecOverride: A ParamSpec derived structure that redirects operations to other types of ParamSpec.
ParamSpecOverrideBuilder
ParamSpecParam: A ParamSpec derived structure that contains the meta data for G_TYPE_PARAM properties.
ParamSpecParamBuilder
ParamSpecPointer: A ParamSpec derived structure that contains the meta data for pointer properties.
ParamSpecPointerBuilder
ParamSpecString: A ParamSpec derived structure that contains the meta data for string properties.
ParamSpecStringBuilder
ParamSpecUChar: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecUCharBuilder
ParamSpecUInt: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecUInt64: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecUInt64Builder
ParamSpecUIntBuilder
ParamSpecULong: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecULongBuilder
ParamSpecUnichar: GLib type: Shared boxed type with reference counted clone semantics.
ParamSpecUnicharBuilder
ParamSpecValueArray: A ParamSpec derived structure that contains the meta data for GValueArray properties.
ParamSpecValueArrayBuilder
ParamSpecVariant: A ParamSpec derived structure that contains the meta data for GVariant properties.
ParamSpecVariantBuilder
Quark
Regex: A GRegex is the “compiled” form of a regular expression pattern.
RegexCompileFlags: Flags specifying compile-time options.
RegexMatchFlags: Flags specifying match-time options.
SignalFlags: The signal flags are used to specify a signal’s behaviour.
SignalGroupv2_74: GSignalGroup manages a collection of signals on a GObject.
Source: The GSource struct is an opaque data type representing an event source. The GSource struct is an opaque data type representing an event source.
SourceFuture: Represents a Future around a glib::Source. The future will be resolved once the source has provided a value
SourceStream: Represents a Stream around a glib::Source. The stream will be provide all values that are provided by the source
SpawnFlags: Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes().
SpawnWithinJoinHandle: Variant of JoinHandle that is returned from MainContext::spawn_from_within.
ThreadHandle: A handle to a thread running on a ThreadPool.
ThreadPool: The GThreadPool struct represents a thread pool.
TimeSpan: A value representing an interval of time, in microseconds.
TimeZone: A GTimeZone represents a time zone, at no particular point in time.
TypeFlags: Bit masks used to check or determine characteristics of a type.
TypeInfo: This structure is used to provide the type system with the information required to initialize and destruct (finalize) a type’s class and its instances.
TypeModule: GTypeModule provides a simple implementation of the GTypePlugin interface.
TypePlugin: An interface that handles the lifecycle of dynamically loaded types.
TypeValueTable: 'i': Integers, passed as collect_values[].v_int'l': Longs, passed as collect_values[].v_long'd': Doubles, passed as collect_values[].v_double'p': Pointers, passed as collect_values[].v_pointer
Uriv2_66: The GUri type and related functions can be used to parse URIs into their components, and build valid URIs from individual components.
UriFlagsv2_66: Flags that describe a URI.
UriHideFlagsv2_66: Flags describing what parts of the URI to hide in g_uri_to_string_partial(). Note that PASSWORD and AUTH_PARAMS will only work if the #GUri was parsed with the corresponding flags.
UriParamsFlagsv2_66: Flags modifying the way parameters are handled by g_uri_parse_params() and #GUriParamsIter.
ValueArray: GLib type: Boxed type with copy-on-clone semantics.
VariantDict: VariantDict is a mutable key/value store where the keys are always strings and the values are Variants.
VariantIter: Iterator over items in a variant.
VariantStrIter: Iterator over items in a variant of type as.
VariantTy: Describes Variant types.
VariantTyIterator: An iterator over the individual components of a tuple VariantTy.
VariantType: Describes Variant types.

Enums§

CharacterDecomposition: The result of a single step of the Unicode canonical decomposition algorithm
ChecksumType: The hashing algorithm to be used by #GChecksum when performing the digest of some data.
ControlFlow: Continue calling the closure in the future iterations or drop it.
ConvertError: Error codes returned by character set conversion routines.
CvtError: A wrapper for ConvertError that can hold an offset into the input string.
DateMonth: Enumeration representing a month; values are January, February, etc. BadMonth is the invalid value.
DateWeekday: Enumeration representing a day of the week; Monday, Tuesday, etc. BadWeekday is an invalid weekday.
DecompositionKind: The kind of decomposition to perform
FileError: Values corresponding to @errno codes returned from file operations on UNIX. Unlike @errno codes, GFileError values are available on all systems, even Windows. The exact meaning of each code depends on what sort of file operation you were performing; the UNIX documentation gives more details. The following error code descriptions come from the GNU C Library manual, and are under the copyright of that manual.
GStrError: Error type holding all possible failures when creating a GStr reference.
GStringFromError: Error type holding all possible failures when creating a GString.
GlibLoggerDomainlog: Enumeration of the possible domain handling behaviours for a GlibLogger.
GlibLoggerFormatlog: Enumeration of the possible formatting behaviours for a GlibLogger.
IConvError: A wrapper for std::io::Error that can hold an offset into an input string.
KeyFileError: Error codes returned by key file parsing.
LogLevel
LogWriterOutput: Return values from #GLogWriterFuncs to indicate whether the given log entry was successfully handled by the writer, or whether there was an error in handling it (and hence a fallback writer should be used).
MarkupError: Error codes returned by markup parsing.
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.
OptionArg: The #GOptionArg enum values determine which type of extra argument the options expect to find. If an option expects an extra argument, it can be specified in several ways; with a short option: -x arg, with a long option: --name arg or combined in a single argument: --name=arg.
SeekType: An enumeration specifying the base position for a g_io_channel_seek_position() operation.
TimeType: Disambiguates a given time in two ways.
UnicodeBreakType: These are the possible line break classifications.
UnicodeScript: The #GUnicodeScript enumeration identifies different writing systems. The values correspond to the names as defined in the Unicode standard. The enumeration has been added in GLib 2.14, and is interchangeable with #PangoScript.
UnicodeType: These are the possible character classifications from the Unicode specification. See Unicode Character Database.
UriErrorv2_66: Error codes returned by #GUri methods.
VariantClass: The range of possible top-level types of #GVariant instances.

Constants§

CLONE_MACRO_LOG_DOMAIN: This is the log domain used by the clone! macro. If you want to use a custom logger (it prints to stdout by default), you can set your own logger using the corresponding log functions.
NONE_STR

Statics§

CSET_A_2_Z: The set of uppercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig. The set of uppercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig.
CSET_DIGITS: The set of ASCII digits. Used for specifying valid identifier characters in #GScannerConfig. The set of ASCII digits. Used for specifying valid identifier characters in #GScannerConfig.
CSET_a_2_z: The set of lowercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig. The set of lowercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig.
KEY_FILE_DESKTOP_GROUP: The name of the main group of a desktop entry file, as defined in the Desktop Entry Specification.
KEY_FILE_DESKTOP_KEY_ACTIONS: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string list giving the available application actions. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string list giving the available application actions.
KEY_FILE_DESKTOP_KEY_CATEGORIES: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the categories in which the desktop entry should be shown in a menu. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the categories in which the desktop entry should be shown in a menu.
KEY_FILE_DESKTOP_KEY_COMMENT: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the tooltip for the desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the tooltip for the desktop entry.
KEY_FILE_DESKTOP_KEY_DBUS_ACTIVATABLE: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true if the application is D-Bus activatable. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true if the application is D-Bus activatable.
KEY_FILE_DESKTOP_KEY_EXEC: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string giving the command line to execute.
KEY_FILE_DESKTOP_KEY_GENERIC_NAME: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the generic name of the desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the generic name of the desktop entry.
KEY_FILE_DESKTOP_KEY_HIDDEN: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry has been deleted by the user. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry has been deleted by the user.
KEY_FILE_DESKTOP_KEY_ICON: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the name of the icon to be displayed for the desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the name of the icon to be displayed for the desktop entry.
KEY_FILE_DESKTOP_KEY_MIME_TYPE: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the MIME types supported by this desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the MIME types supported by this desktop entry.
KEY_FILE_DESKTOP_KEY_NAME: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the specific name of the desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the specific name of the desktop entry.
KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should not display the desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should not display the desktop entry.
KEY_FILE_DESKTOP_KEY_NO_DISPLAY: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry should be shown in menus. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry should be shown in menus.
KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should display the desktop entry. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should display the desktop entry.
KEY_FILE_DESKTOP_KEY_PATH: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string containing the working directory to run the program in.
KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the application supports the Startup Notification Protocol Specification. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the application supports the Startup Notification Protocol Specification.
KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is string identifying the WM class or name hint of a window that the application will create, which can be used to emulate Startup Notification with older applications. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is string identifying the WM class or name hint of a window that the application will create, which can be used to emulate Startup Notification with older applications.
KEY_FILE_DESKTOP_KEY_TERMINAL: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the program should be run in a terminal window.
KEY_FILE_DESKTOP_KEY_TRY_EXEC: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string giving the file name of a binary on disk used to determine if the program is actually installed.
KEY_FILE_DESKTOP_KEY_TYPE: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string giving the type of the desktop entry.
KEY_FILE_DESKTOP_KEY_URL: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string giving the URL to access.
KEY_FILE_DESKTOP_KEY_VERSION: A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string giving the version of the Desktop Entry Specification used for the desktop entry file. A key under GLib::KEY_FILE_DESKTOP_GROUP, whose value is a string giving the version of the Desktop Entry Specification used for the desktop entry file.
KEY_FILE_DESKTOP_TYPE_APPLICATION: The value of the GLib::KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing applications. The value of the GLib::KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing applications.
KEY_FILE_DESKTOP_TYPE_DIRECTORY: The value of the GLib::KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing directories. The value of the GLib::KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing directories.
KEY_FILE_DESKTOP_TYPE_LINK: The value of the GLib::KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing links to documents. The value of the GLib::KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing links to documents.
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 argv. The option must be of type OptionArg::Callback, OptionArg::StringArray or OptionArg::FilenameArray.
STR_DELIMITERS: The standard delimiters, used in strdelimit(). The standard delimiters, used in strdelimit().
TEST_OPTION_ISOLATE_DIRSv2_60: A value that can be passed as an option to test_init().
TEST_OPTION_NONFATAL_ASSERTIONSv2_84: A value that can be passed as an option to test_init().
TEST_OPTION_NO_PRGNAMEv2_84: A value that can be passed as an option to test_init().
URI_RESERVED_CHARS_GENERIC_DELIMITERS: Generic delimiters characters as defined in RFC 3986. Includes :/?#[]@. Generic delimiters characters as defined in RFC 3986. Includes :/?#[]@.
URI_RESERVED_CHARS_SUBCOMPONENT_DELIMITERS: Subcomponent delimiter characters as defined in RFC 3986. Includes !$&'()*+,;=. Subcomponent delimiter characters as defined in RFC 3986. Includes !$&'()*+,;=.

Traits§

HasParamSpec
IntoGStr: A trait to accept both &str or &GStr as an argument.
IntoOptionalGStr: A trait to accept both Option<&str> or Option<&GStr> as an argument.
ParamSpecBuilderExt: A trait implemented by the various ParamSpec builder types.
ParamSpecType
Unichar: This trait provides access to Unicode character classification and manipulations functions provided by GLib that do not exist in the standard library

Functions§

access
application_name
base64_decode
base64_encode
casefold
charset: Obtain the character set for the current locale.
check_version
child_watch_future: Create a Future that will resolve once the child process with the given pid exits
child_watch_future_with_priority: Create a Future that will resolve once the child process with the given pid exits
codeset
compute_checksum_for_bytes
compute_checksum_for_data
compute_checksum_for_string
compute_hmac_for_bytes
compute_hmac_for_data
console_charsetv2_62
convert
convert_with_fallback
current_dir
dcgettext
dgettext
dngettext
dpgettext
dpgettext2
environ
environ_getenv
file_get_contents
file_open_tmp
file_set_contents
file_set_contents_fullv2_66
filename_charsets
filename_display_basename
filename_display_name
filename_from_uri
filename_from_utf8
filename_to_uri
filename_to_utf8
find_program_in_path
format_size
format_size_full
future_with_timeout: Add a timeout to a Future.
future_with_timeout_with_priority: Add a timeout to a Future.
getenv
home_dir
host_name
hostname_is_ascii_encoded: Tests if @hostname contains segments with an ASCII-compatible encoding of an Internationalized Domain Name. If this returns true, you should decode the hostname with g_hostname_to_unicode() before displaying it to the user.
hostname_is_ip_address: Tests if @hostname is the string form of an IPv4 or IPv6 address. (Eg, “192.168.0.1”.)
hostname_is_non_ascii: Tests if @hostname contains Unicode characters. If this returns true, you need to encode the hostname with g_hostname_to_ascii() before using it in non-IDN-aware contexts.
hostname_to_ascii: Converts @hostname to its canonical ASCII form; an ASCII-only string containing no uppercase letters and not ending with a trailing dot.
hostname_to_unicode: Converts @hostname to its canonical presentation form; a UTF-8 string in Unicode normalization form C, containing no uppercase letters, no forbidden characters, and no ASCII-encoded segments, and not ending with a trailing dot.
interval_stream: Create a Stream that will provide a value every given number of milliseconds.
interval_stream_seconds: Create a Stream that will provide a value every given number of seconds.
interval_stream_seconds_with_priority: Create a Stream that will provide a value every given number of seconds.
interval_stream_with_priority: Create a Stream that will provide a value every given number of milliseconds.
is_canonical_pspec_name
language_names
language_names_with_categoryv2_58
listenv: Gets the names of all variables set in the environment.
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. 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 into a UTF-8 string.
locale_variants
log_default_handler
log_remove_handler
log_set_always_fatal
log_set_default_handler: To set back the default print handler, use the log_unset_default_handler function.
log_set_fatal_mask
log_set_handler
log_set_writer_func
log_structured_array
log_unset_default_handler: To set the default print handler, use the log_set_default_handler function.
log_variant
log_writer_default
log_writer_default_set_use_stderr^⚠: Sets whether GLib log functions output to stderr or stdout.
log_writer_default_would_drop
log_writer_format_fields
log_writer_is_journald
log_writer_journald
log_writer_standard_streams
log_writer_supports_color
main_current_source: Returns the currently firing source for this thread.
main_depth: Returns the depth of the stack of calls to MainContext::dispatch() on any #GMainContext in the current thread. That is, when called from the toplevel, it gives 0. When called from within a callback from MainContext::iteration() (or MainLoop::run(), etc.) it returns 1. When called from within a callback to a recursive call to MainContext::iteration(), it returns 2. And so forth.
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.
mkdir_with_parents: Create a directory if it doesn’t already exist. Create intermediate parent directories as needed, too.
mkdtemp: Creates a temporary directory. See the mkdtemp() documentation on most UNIX-like systems.
mkdtemp_full: Creates a temporary directory. See the mkdtemp() documentation on most UNIX-like systems.
mkstemp: Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems.
mkstemp_full: Opens a temporary file. See the mkstemp() documentation on most UNIX-like systems.
monotonic_time
normalize
num_processors
on_error_query: Prompts the user with [E]xit, [H]alt, show [S]tack trace or [P]roceed. This function is intended to be used for debugging use only. The following example shows how it can be used together with the g_log() functions.
on_error_stack_trace: Invokes gdb, which attaches to the current process and shows a stack trace. Called by g_on_error_query() when the “[S]tack trace” option is selected. You can get the current process’s program name with g_get_prgname(), assuming that you have called gtk_init() or gdk_init().
os_infov2_64
prgname
program_name: Same as get_prgname().
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 [@begin..@end).
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 [@begin..@end-1].
random_set_seed: Sets the seed for the global random number generator, which is used by the g_random_* functions, to @seed.
real_name
real_time
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.
rust_log_handlerlog: Provides a glib log handler which routes all logging messages to the log crate.
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. g_set_prgname() will be called automatically by gtk_init(), but g_set_application_name() will not.
set_prgname
set_print_handler: To set back the default print handler, use the unset_print_handler function.
set_printerr_handler: To set back the default print handler, use the unset_printerr_handler function.
set_program_name: Same as set_prgname().
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.
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 @unquoted_string.
shell_unquote: Unquotes a string as the shell (/bin/sh) would.
spaced_primes_closest: Gets the smallest prime number from a built-in array of primes which is larger than @num. This is used within GLib to calculate the optimum size of a #GHashTable.
spawn_async: Executes a child program asynchronously.
spawn_async_with_fdsv2_58 and non-Windows
spawn_async_with_pipesNon-Windows
spawn_check_exit_statusDeprecated: An old name for g_spawn_check_wait_status(), deprecated because its name is misleading.
spawn_check_wait_statusv2_70: Set @error if @wait_status indicates the child exited abnormally (e.g. with a nonzero exit code, or via a fatal signal).
spawn_command_line_asyncUnix: A simple version of g_spawn_async() that parses a command line with g_shell_parse_argv() and passes it to g_spawn_async().
spawn_future: Spawn a new infallible Future on the thread-default main context.
spawn_future_local: Spawn a new infallible Future on the thread-default main context.
system_config_dirs
system_data_dirs
timeout_future: Create a Future that will resolve after the given number of milliseconds.
timeout_future_seconds: Create a Future that will resolve after the given number of seconds.
timeout_future_seconds_with_priority: Create a Future that will resolve after the given number of seconds.
timeout_future_with_priority: Create a Future that will resolve after the given number of milliseconds.
tmp_dir
unix_open_pipe: Similar to the UNIX pipe() call, but on modern systems like Linux uses the pipe2() system call, which atomically creates a pipe with the configured flags.
unix_signal_futureUnix: Create a Future that will resolve once the given UNIX signal is raised
unix_signal_future_with_priorityUnix: Create a Future that will resolve once the given UNIX signal is raised
unix_signal_streamUnix: Create a Stream that will provide a value whenever the given UNIX signal is raised
unix_signal_stream_with_priorityUnix: Create a Stream that will provide a value whenever the given UNIX signal is raised
unlink: A wrapper for the POSIX unlink() function. The unlink() function deletes a name from the filesystem. If this was the last link to the file and no processes have it opened, the diskspace occupied by the file is freed.
unset_print_handler: To set the default print handler, use the set_print_handler function.
unset_printerr_handler: To set the default print handler, use the set_printerr_handler function.
unsetenv: Removes an environment variable from the environment.
uri_escape_string
uri_parse_scheme
uri_unescape_segment
uri_unescape_string
user_cache_dir
user_config_dir
user_data_dir
user_name
user_runtime_dir
user_special_dir
user_state_dirv2_72
usleep: Pauses the current thread for the given number of microseconds.
utf8_to_utf32
utf32_to_utf8
uuid_string_is_valid: Parses the string @str and verify if it is a UUID.
uuid_string_random: Generates a random UUID (RFC 4122 version 4) as a string. It has the same randomness guarantees as #GRand, so must not be used for cryptographic purposes such as key generation, nonces, salts or one-time pads.

Type Aliases§

DateDay
DateYear
Time

Attribute Macros§

async_test: An attribute macro for writing asynchronous test functions.
derived_properties: When applied to ObjectImpl
flags: Attribute macro for defining flags using the bitflags crate. This macro will also define a GFlags::type_ function and the glib::Value traits.
object_interface: Macro for boilerplate of ObjectInterface implementations.
object_subclass: Macro for boilerplate of ObjectSubclass implementations.

Derive Macros§

Boxed: Derive macro for defining a BoxedType::type_ function and the glib::Value traits. Optionally, the type can be marked as nullable to get an implementation of glib::value::ToValueOptional.
Downgrade: Macro for deriving implementations of glib::clone::Downgrade and glib::clone::Upgrade traits and a weak type.
Enum: Derive macro to register a Rust enum in the GLib type system and derive the glib::Value traits.
ErrorDomain: Derive macro for defining a GLib error domain and its associated ErrorDomain trait.
Properties: This macro enables you to derive object properties in a quick way.
SharedBoxed: Derive macro for defining a SharedType::get_type function and the glib::Value traits. Optionally, the type can be marked as nullable to get an implementation of glib::value::ToValueOptional.
ValueDelegate: Example
Variant: Derive macro for serializing/deserializing custom structs/enums as glib::Variants.

Crate glibCopy item path