module Gio::Initable
Overview
#GInitable is implemented by objects that can fail during initialization. If an object implements this interface then it must be initialized as the first thing after construction, either via g_initable_init() or g_async_initable_init_async() (the latter is only available if it also implements #GAsyncInitable).
If the object is not initialized, or initialization returns with an error, then all operations on the object except g_object_ref() and g_object_unref() are considered to be invalid, and have undefined behaviour. They will often fail with g_critical() or g_warning(), but this must not be relied on.
Users of objects implementing this are not intended to use
the interface method directly, instead it will be used automatically
in various ways. For C applications you generally just call
g_initable_new() directly, or indirectly via a foo_thing_new() wrapper.
This will call g_initable_init() under the cover, returning nil
and
setting a #GError on failure (at which point the instance is
unreferenced).
For bindings in languages where the native constructor supports exceptions the binding could check for objects implementing %GInitable during normal construction and automatically initialize them, throwing an exception on failure.
Direct including types
- Gdk::VulkanContext
- Gio::CharsetConverter
- Gio::DBusConnection
- Gio::DBusObjectManagerClient
- Gio::DBusProxy
- Gio::DBusServer
- Gio::DebugControllerDBus
- Gio::InetAddressMask
- Gio::Socket
- Gio::Subprocess
Defined in:
lib/gi-crystal/src/auto/gio-2.0/initable.crConstructors
-
.cast(obj : GObject::Object) : self
Cast a
GObject::Object
toself
, throws aTypeCastError
if the cast can't be made.
Class Method Summary
Instance Method Summary
- #init(cancellable : Gio::Cancellable | Nil) : Bool
-
#newv(object_type : UInt64, parameters : Enumerable(GObject::Parameter), cancellable : Gio::Cancellable | Nil) : GObject::Object
DEPRECATED
- #to_unsafe
Constructor Detail
Cast a GObject::Object
to self
, throws a TypeCastError
if the cast can't be made.
Class Method Detail
Instance Method Detail
DEPRECATED