TypeModuleRef
public struct TypeModuleRef : TypeModuleProtocol, GWeakCapturing
GTypeModule
provides a simple implementation of the GTypePlugin
interface.
The model of GTypeModule
is a dynamically loaded module which
implements some number of types and interface implementations.
When the module is loaded, it registers its types and interfaces
using g_type_module_register_type()
and g_type_module_add_interface()
.
As long as any instances of these types and interface implementations
are in use, the module is kept loaded. When the types and interfaces
are gone, the module may be unloaded. If the types and interfaces
become used again, the module will be reloaded. Note that the last
reference cannot be released from within the module code, since that
would lead to the caller’s code being unloaded before g_object_unref()
returns to it.
Keeping track of whether the module should be loaded or not is done by
using a use count - it starts at zero, and whenever it is greater than
zero, the module is loaded. The use count is maintained internally by
the type system, but also can be explicitly controlled by
g_type_module_use()
and g_type_module_unuse()
. Typically, when loading
a module for the first type, g_type_module_use()
will be used to load
it so that it can initialize its types. At some later point, when the
module no longer needs to be loaded except for the type
implementations it contains, g_type_module_unuse()
is called.
GTypeModule
does not actually provide any implementation of module
loading and unloading. To create a particular module type you must
derive from GTypeModule
and implement the load and unload functions
in GTypeModuleClass
.
The TypeModuleRef
type acts as a lightweight Swift reference to an underlying GTypeModule
instance.
It exposes methods that can operate on this data type through TypeModuleProtocol
conformance.
Use TypeModuleRef
only as an unowned
reference to an existing GTypeModule
instance.
-
Untyped pointer to the underlying `GTypeModule` instance.
For type-safe access, use the generated, typed pointer
type_module_ptr
property instead.Declaration
Swift
public let ptr: UnsafeMutableRawPointer!
-
Designated initialiser from the underlying
C
data typeDeclaration
Swift
@inlinable init(_ p: UnsafeMutablePointer<GTypeModule>)
-
Designated initialiser from a constant pointer to the underlying
C
data typeDeclaration
Swift
@inlinable init(_ p: UnsafePointer<GTypeModule>)
-
Conditional initialiser from an optional pointer to the underlying
C
data typeDeclaration
Swift
@inlinable init!(_ maybePointer: UnsafeMutablePointer<GTypeModule>?)
-
Conditional initialiser from an optional, non-mutable pointer to the underlying
C
data typeDeclaration
Swift
@inlinable init!(_ maybePointer: UnsafePointer<GTypeModule>?)
-
Conditional initialiser from an optional
gpointer
Declaration
Swift
@inlinable init!(gpointer g: gpointer?)
-
Conditional initialiser from an optional, non-mutable
gconstpointer
Declaration
Swift
@inlinable init!(gconstpointer g: gconstpointer?)
-
Reference intialiser for a related type that implements
TypeModuleProtocol
Declaration
Swift
@inlinable init<T>(_ other: T) where T : TypeModuleProtocol
-
This factory is syntactic sugar for setting weak pointers wrapped in
GWeak<T>
Declaration
Swift
@inlinable static func unowned<T>(_ other: T) -> TypeModuleRef where T : TypeModuleProtocol
-
Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
TypeModuleProtocol
.Declaration
Swift
@inlinable init<T>(cPointer: UnsafeMutablePointer<T>)
-
Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
TypeModuleProtocol
.Declaration
Swift
@inlinable init<T>(constPointer: UnsafePointer<T>)
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
TypeModuleProtocol
.Declaration
Swift
@inlinable init(mutating raw: UnsafeRawPointer)
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
TypeModuleProtocol
.Declaration
Swift
@inlinable init(raw: UnsafeMutableRawPointer)
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
TypeModuleProtocol
.Declaration
Swift
@inlinable init(opaquePointer: OpaquePointer)