Back to Seed Clases

Gio

Classes

Interfaces

Structs

Unions

Enums

Interface Gio.Initable

Import line:	Gio = imports.gi.Gio;
GIR File:	Gio-2.0.gir
C documentation:	GInitable
Interface :	Initable
Implementations:	Gio.CharsetConverter, Gio.DBusConnection, Gio.DBusProxy, Gio.DBusServer, Gio.Socket

GInitable is implemented by objects that can fail during
initialization. If an object implements this interface the
g_initable_init() function must be called as the first thing
after construction. If g_initable_init() is not called, or if
it returns an error, all further operations on the object
should fail, generally with a G_IO_ERROR_NOT_INITIALIZED error.
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 NULL 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 implemention GInitable
during normal construction and automatically initialize them, throwing
an exception on failure.

Properties
None

Methods / Constructors
Method / Constructor		Defined By
	init (Cancellable *cancellable) : gboolean Initializes the object implementing the interface. Initializes the object implementing the interface. This must be done before any real use of the object after initial construction. Implementations may also support cancellation. If cancellable* is not NULL, then initialization can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If cancellable is not NULL and the object doesn't support cancellable initialization the error G_IO_ERROR_NOT_SUPPORTED will be returned. If this function is not called, or returns with an error then all operations on the object should fail, generally returning the error G_IO_ERROR_NOT_INITIALIZED. Implementations of this method must be idempotent, i.e. multiple calls to this function with the same argument should return the same results. Only the first call initializes the object, further calls return the result of the first call. This is so that its safe to implement the singleton pattern in the GObject constructor function. return FALSE and set error appropriately if present. Parameters: Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Returns: gboolean TRUE if successful. If an error has occurred, this function will	Gio.Initable

Events
None