GTypePlugin
GTypePlugin — An interface for dynamically loadable types
|
|
Object Hierarchy
GInterface
╰── GTypePlugin
Known Implementations
GTypePlugin is implemented by
GTypeModule.
Includes
#include <glib-object.h>
Description
The GObject type system supports dynamic loading of types.
The GTypePlugin interface is used to handle the lifecycle
of dynamically loaded types. It goes as follows:
So basically, you need to implement a GTypePlugin type that
carries a use_count, once use_count goes from zero to one, you need
to load the implementation to successfully handle the upcoming
g_type_plugin_complete_type_info() call. Later, maybe after
succeeding use/unuse calls, once use_count drops to zero, you can
unload the implementation again. The type system makes sure to call
g_type_plugin_use() and g_type_plugin_complete_type_info() again
when the type is needed again.
GTypeModule is an implementation of GTypePlugin that already
implements most of this except for the actual module loading and
unloading. It even handles multiple registered types per module.
Functions
GTypePluginUse ()
void
(*GTypePluginUse) (GTypePlugin *plugin);
The type of the use_plugin
function of GTypePluginClass, which gets called
to increase the use count of plugin
.
g_type_plugin_use ()
void
g_type_plugin_use (GTypePlugin *plugin);
Calls the use_plugin
function from the GTypePluginClass of
plugin
. There should be no need to use this function outside of
the GObject type system itself.
g_type_plugin_unuse ()
void
g_type_plugin_unuse (GTypePlugin *plugin);
Calls the unuse_plugin
function from the GTypePluginClass of
plugin
. There should be no need to use this function outside of
the GObject type system itself.
g_type_plugin_complete_type_info ()
void
g_type_plugin_complete_type_info (GTypePlugin *plugin,
GType g_type,
GTypeInfo *info,
GTypeValueTable *value_table);
Calls the complete_type_info
function from the GTypePluginClass of plugin
.
There should be no need to use this function outside of the GObject
type system itself.
g_type_plugin_complete_interface_info ()
void
g_type_plugin_complete_interface_info (GTypePlugin *plugin,
GType instance_type,
GType interface_type,
GInterfaceInfo *info);
Calls the complete_interface_info
function from the
GTypePluginClass of plugin
. There should be no need to use this
function outside of the GObject type system itself.
Types and Values
GTypePlugin
typedef struct _GTypePlugin GTypePlugin;
The GTypePlugin typedef is used as a placeholder
for objects that implement the GTypePlugin interface.
struct GTypePluginClass
struct GTypePluginClass {
GTypePluginUse use_plugin;
GTypePluginUnuse unuse_plugin;
GTypePluginCompleteTypeInfo complete_type_info;
GTypePluginCompleteInterfaceInfo complete_interface_info;
};
The GTypePlugin interface is used by the type system in order to handle
the lifecycle of dynamically loaded types.