Dex – 1

DexAsyncResult is used to integrate a DexFuture with GAsyncResult.

DexBlock represents a callback closure that can be scheduled to run within a specific GMainContext.

DexCancellable is a simple cancellation primitive which allows for you to create DexFuture that will reject upon cancellation.

DexCoroutine is a DexFuture implemented as a stateful stackless coroutine cooperatively scheduled on a DexScheduler.

DexDelayed is a future which will resolve or reject the value of another DexFuture when dex_delayed_release() is called.

DexFiber is a fiber (a stack-based coroutine) which itself is a DexFuture.

DexFuture is the base class representing a future which may resolve with a value or reject with error at some point in the future.

This class provides a GListModel implementation that will expand to the contents of another GListModel from a DexFuture.

since: 1.1

DexFutureSet represents a set of DexFuture.

DexLimiter limits the number of operations running concurrently.

unstable since: 1.2

DexMainScheduler is the scheduler used on the default thread of an application. It is meant to integrate with your main loop.

DexObject is the basic building block of types defined within libdex. Futures, Schedulers, and Channels all inherit from DexObject which provides features like thread-safe weak pointers and memory management operations.

DexPromise is a convenient DexFuture for propagating a result or rejection in application and library code.

DexScheduler is the base class used by schedulers.

DexStaticFuture represents a future that is resolved from the initial state.

A structured scope for related DexFuture instances.

unstable since: 1.2

DexThreadPool is a thread pool for managing native OS threads similar to GThreadPool.

unstable since: 1.2

DexThreadPoolScheduler is a DexScheduler that will dispatch work items and fibers to sub-schedulers on a specific operating system thread.

DexTimeout is a DexFuture that will reject after the configured period of time.

DexUnixSignal is a DexFuture that will resolve when a specific unix signal has been received.

This function prototype is used for spawning stackless coroutines.

This function prototype is used for spawning fibers. A fiber is a lightweight, cooperative-multitasking feature where the fiber is given its own stack. The fiber runs until it reaches a point of suspension (using dex_await() or similar) or exits the fiber.

A DexFutureCallback can be executed from a DexBlock as response to another DexFuture resolving or rejecting.

A function which will be run on a dedicated thread.

since: 1.0

An asynchronous close() wrapper.

unstable since: 1.2

An asynchronous open() wrapper.

unstable since: 1.2

An asynchronous pread() wrapper.

An asynchronous pwrite() wrapper.

Wraps g_app_info_get_default_for_type_async().

unstable since: 1.2

Wraps g_app_info_get_default_for_uri_scheme_async().

unstable since: 1.2

Wraps g_app_info_launch_default_for_uri_async().

unstable since: 1.2

Wraps g_app_info_launch_uris_async().

unstable since: 1.2

A helper for g_async_initable_init_async().

since: 1.0

Creates and asynchronously initializes a new object.

unstable since: 1.2

Wraps g_buffered_input_stream_fill_async().

unstable since: 1.2

Wrapper for g_bus_get().

since: 0.4

Wrapper for g_bus_own_name().

since: 1.1

Reads a line from the data input stream.

since: 1.1

Reads a UTF-8 line from the data input stream.

unstable since: 1.2

Reads data from the stream until one of stop_chars is found.

unstable since: 1.2

Wrapper for g_dbus_connection_call().

since: 0.4

Wrapper for g_dbus_connection_call_with_unix_fd_list().

since: 0.4

Asynchronously closes a connection.

since: 1.0

Wrapper for g_dbus_connection_send_message_with_reply().

since: 0.4

Wraps g_dtls_connection_close_async().

unstable since: 1.2

Wraps g_dtls_connection_handshake_async().

unstable since: 1.2

Wraps g_dtls_connection_shutdown_async().

unstable since: 1.2

Creates a new GSource that will fire when events is satisfied.

since: 1.1

Wraps g_file_append_to_async() as a DexFuture.

unstable since: 1.2

Asynchronously copies a file and returns a DexFuture which can be observed for the result.

Wraps g_file_copy_async() with progress callback support.

unstable since: 1.2

Wraps g_file_create() as a DexFuture.

since: 1.1

Wraps g_file_create_readwrite_async() as a DexFuture.

unstable since: 1.2

Asynchronously deletes a file and returns a DexFuture which can be observed for the result.

Wraps g_file_enumerator_close_async().

unstable since: 1.2

Wraps g_file_enumerator_next_files_async().

Wraps g_file_find_enclosing_mount_async().

unstable since: 1.2

Wraps g_file_input_stream_query_info_async().

unstable since: 1.2

Wraps g_file_io_stream_query_info_async().

unstable since: 1.2

Wraps g_file_load_bytes_async().

unstable since: 1.2

Wraps g_file_load_partial_contents_async().

unstable since: 1.2

Asynchronously creates a directory and returns DexFuture which can be observed for the result.

Creates a directory at file.

since: 1.0

Wraps g_file_make_symbolic_link_async().

unstable since: 1.2

Wraps g_file_new_tmp_dir_async() as a DexFuture.

unstable since: 1.2

Wraps g_file_open_readwrite_async() as a DexFuture.

unstable since: 1.2

Wraps g_file_output_stream_query_info_async().

unstable since: 1.2

Wraps Gio.File.query_default_handler_async.

unstable since: 1.2

Queries to see if file exists asynchronously.

since: 0.6

Wraps g_file_query_filesystem_info_async().

unstable since: 1.2

Asynchronously opens a file for reading.

Opens a stream that will replace file on disk when the input stream is closed.

Wraps g_file_replace_contents_async().

unstable since: 1.2

Wraps g_file_replace_contents_bytes_async().

Wraps g_file_replace_readwrite_async() as a DexFuture.

unstable since: 1.2

since: 1.0

Wraps g_file_set_display_name_async().

unstable since: 1.2

Wraps g_file_trash_async().

unstable since: 1.2

Locates the first executable named program in the user’s path.

since: 1.1

Gets the major version number equivalent to DEX_MAJOR_VERSION at compile time of libdex.

since: 1.1

Gets the micro version number equivalent to DEX_MICRO_VERSION at compile time of libdex.

since: 1.1

Gets the minor version number equivalent to DEX_MINOR_VERSION at compile time of libdex.

since: 1.1

Reads count bytes from an input stream into a pre-allocated buffer. The buffer must stay valid for the lifetime of this future.

Reads count bytes from the stream.

Wraps Gio.IOStream.splice_async.

unstable since: 1.2

Similar to g_mkdir_with_parents() but runs on a dedicated thread.

since: 1.1

Wraps g_network_monitor_can_reach_async().

unstable since: 1.2

Wraps g_output_stream_flush_async().

unstable since: 1.2

Writes bytes to stream.

Writes all bytes in vectors to stream.

unstable since: 1.2

Creates a new GObject.ParamSpec instance specifying a DEX_TYPE_OBJECT derived property.

unstable since: 1.2

Wraps g_permission_acquire_async().

unstable since: 1.2

Wraps g_permission_release_async().

unstable since: 1.2

Wraps g_proxy_connect_async().

unstable since: 1.2

Wraps g_proxy_resolver_lookup_async().

unstable since: 1.2

Wraps g_resolver_lookup_by_address_async().

unstable since: 1.2

Wraps g_resolver_lookup_by_name_with_flags_async().

unstable since: 1.2

Wraps g_resolver_lookup_records_async().

unstable since: 1.2

Wraps g_resolver_lookup_service_async().

unstable since: 1.2

Wraps g_socket_address_enumerator_next_async().

unstable since: 1.2

Wraps g_socket_client_connect_to_host_async().

unstable since: 1.2

Wraps g_socket_client_connect_to_service_async().

unstable since: 1.2

Wraps g_socket_client_connect_to_uri_async().

unstable since: 1.2

Wraps g_socket_connection_connect_async().

unstable since: 1.2

Creates a DexFuture that resolves when socket satisfies condition.

unstable since: 1.2

Wraps g_subprocess_wait_async().

unstable since: 1.2

Creates a future that awaits for subprocess to complete using g_subprocess_wait_check_async().

since: 0.4

Adds a test function like g_test_add_func(), but runs test_func from a DexFiber. The calling thread is given a thread-default DexScheduler if it does not already have one, allowing tests to use dex_await() and related APIs directly.

Spawns a new thread named thread_name running thread_func with user_data passed to it.

since: 1.0

Use this when running on a thread spawned with dex_thread_spawn() and you need to block the thread until future has resolved or rejected.

since: 1.0

unstable since: 1.2

Wraps g_tls_database_lookup_certificate_for_handle_async().

unstable since: 1.2

Wraps g_tls_database_lookup_certificate_issuer_async().

unstable since: 1.2

Wraps g_tls_database_lookup_certificates_issued_by_async().

unstable since: 1.2

Wraps g_tls_database_verify_chain_async().

unstable since: 1.2

Wraps g_tls_interaction_ask_password_async().

unstable since: 1.2

Wraps g_tls_interaction_request_certificate_async().

unstable since: 1.2

Wraps g_unix_connection_receive_credentials_async().

unstable since: 1.2

Wraps g_unix_connection_send_credentials_async().

unstable since: 1.2

This runs g_unlink() on a dedicated thread.

since: 1.1

Retrieves the DexObject stored inside the given value.

since: 1.0

Retrieves the DexObject stored inside the given value.

since: 0.4

Stores the given DexObject inside value.

since: 0.4

Stores the given DexObject inside value.

since: 0.4

Declaration helper for object pointer fields.

Clears object fields using g_clear_object().

Declaration helper for pointer-like fields.

Clears pointer fields when a closure state is freed.

Declaration helper for value fields.

Clears value fields when a closure state is freed.

Used in a coroutine function body to establish coroutine state.

An object pointer field descriptor for #DEX_DEFINE_CLOSURE_TYPE().

A pointer field descriptor for #DEX_DEFINE_CLOSURE_TYPE().

This macro is a lightweight helper for quickly defining closure-like state structs with matching type_prefix_new() and type_prefix_free() helpers.

unstable since: 1.2

A value field descriptor for #DEX_DEFINE_CLOSURE_TYPE().