Crate glib

source ·
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 gtk::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 gtk::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§

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§

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§

Traits§

Functions§

  • access
    A wrapper for the POSIX access() function. This function is used to test a pathname for one or several of read, write or execute permissions, or just existence.
  • 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 g_set_application_name() has not been called, returns the result of g_get_prgname() (which may be None if g_set_prgname() has also not been called).
  • 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.
  • base64_encode
    Encode a sequence of binary data into its Base-64 stringified representation.
  • casefold
  • charset
    Obtain the character set for the current locale.
  • check_version
    Checks that the GLib library in use is compatible with the given 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
    Gets the character set for the current locale.
  • compute_checksum_for_bytes
    Computes the checksum for a binary @data. This is a convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free().
  • compute_checksum_for_data
    Computes the checksum for a binary @data of @length. This is a convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free().
  • compute_hmac_for_bytes
    Computes the HMAC for a binary @data. This is a convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref().
  • compute_hmac_for_data
    Computes the HMAC for a binary @data of @length. This is a convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref().
  • console_charsetv2_62
    Obtains the character set used by the console attached to the process, which is suitable for printing output to the terminal.
  • convert
    Converts a string from one character set to another.
  • 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 @fallback will be honored. Some systems may do an approximate conversion from @from_codeset to @to_codeset in their iconv() functions, in which case GLib will simply return that approximate conversion.
  • current_dir
    Gets the current directory.
  • dcgettext
    This is a variant of g_dgettext() that allows specifying a locale category instead of always using LC_MESSAGES. See g_dgettext() for more information about how this functions differs from calling dcgettext() directly.
  • dgettext
    This function is a wrapper of dgettext() which does not translate the message if the default domain as set with textdomain() has no translations for the current locale.
  • dngettext
    This function is a wrapper of dngettext() which does not translate the message if the default domain as set with textdomain() has no translations for the current locale.
  • dpgettext
    This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the ‘\004’ character to separate the message context and message id in @msgctxtid. If 0 is passed as @msgidoffset, this function will fall back to trying to use the deprecated convention of using “|” as a separation character.
  • dpgettext2
    This function is a variant of g_dgettext() which supports a disambiguating message context. GNU gettext uses the ‘\004’ character to separate the message context and message id in @msgctxtid.
  • environ
    Gets the list of environment variables for the current process.
  • environ_getenv
  • 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_set_contents
    Writes all of @contents to a file named @filename. This is a convenience wrapper around calling g_file_set_contents_full() with flags set to G_FILE_SET_CONTENTS_CONSISTENT | G_FILE_SET_CONTENTS_ONLY_EXISTING and mode set to 0666.
  • file_set_contents_fullv2_66
    Writes all of @contents to a file named @filename, with good error checking. If a file called @filename already exists it will be overwritten.
  • filename_charsets
    Determines the preferred character sets used for filenames. The first character set from the @charsets is the filename encoding, the subsequent character sets are used when trying to generate a displayable representation of a filename, see g_filename_display_name().
  • 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.
  • 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-None even if the filename actually isn’t in the GLib file name encoding.
  • 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 @program in the user’s path, in the same way that execvp() would locate it. Returns an allocated string with the absolute path name, or None if the program is not found in the path. If @program is already an absolute path, returns a copy of @program if @program exists and is executable, and None otherwise.
  • 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.
  • format_size_full
    Formats a size.
  • future_with_timeout
    Add a timeout to a Future.
  • future_with_timeout_with_priority
    Add a timeout to a Future.
  • getenv
    Returns the value of an environment variable.
  • home_dir
    Gets the current user’s home directory.
  • host_name
    Return a name for the machine.
  • 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
    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”.
  • language_names_with_categoryv2_58
    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”.
  • 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][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.
  • locale_variants
    Returns a list of derived variants of @locale, which can be used to e.g. construct locale-dependent filenames or search paths. The returned list is sorted from most desirable to least desirable. This function handles territory, charset and extra locale modifiers. See setlocale(3) for information about locales and their format.
  • 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 g_main_context_dispatch() on any #GMainContext in the current thread. That is, when called from the toplevel, it gives 0. When called from within a callback from g_main_context_iteration() (or g_main_loop_run(), etc.) it returns 1. When called from within a callback to a recursive call to g_main_context_iteration(), it returns 2. And so forth.
  • 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
    Queries the system monotonic time.
  • normalize
  • 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 g_thread_pool_new() for CPU bound tasks and similar cases.
  • 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
    Get information about the operating system.
  • 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
    Gets the real name of the user. This usually comes from the user’s entry in the passwd file. The encoding of the returned string is system-defined. (On Windows, it is, however, always UTF-8.) If the real user name cannot be determined, the string “Unknown” is returned.
  • real_time
    Queries the system wall-clock 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
    Returns an ordered list of base directories in which to access system-wide configuration information.
  • system_data_dirs
    Returns an ordered list of base directories in which to access system-wide application data.
  • 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
    Gets the directory to use for temporary files.
  • 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
    Returns a base directory in which to store non-essential, cached data specific to particular user.
  • user_config_dir
    Returns a base directory in which to store user-specific application configuration information such as user preferences and settings.
  • user_data_dir
    Returns a base directory in which to access application data such as icons that is customized for a particular user.
  • 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.
  • user_runtime_dir
    Returns a directory that is unique to the current user on the local system.
  • user_special_dir
    Returns the full path of a special directory using its logical id.
  • user_state_dirv2_72
    Returns a base directory in which to store state files specific to particular user.
  • 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§

Attribute Macros§

Derive Macros§