GObject 08: A class with a signal
A GObject may emit signals to show that something have happened. Signals can be connected to many "handlers"which are called when the signals are emitted.
Full code:
A signal is created using g_signal_new.
You need a name for it. It should be a combination of lower-case letters and hyphens ('-'). You also need to specify the class it associtated to. Then you tell it the type of the parameters as well as the return value of the signal handler.
A GSignalCMarshaller is required. It is specific to each combination of parameter types and return-value type. There are many such marshaller functions provided by default. If there is not one for yours, you can create one with the glib-genmarshal command-line utility.
Signals are connected to functions with g_signal_connect and emitted with g_signal_emit or g_signal_emit_by_name.
Note that the first parameter of each signal handler function is always a GObject pointer pointing to the object which emitted the signal. The last parameter is the custom data provided in g_signal_connedt. The parameters in between are those specified in g_signal_new.
Full code:
/* A subclass of GObject with a property. */
#include <stdio.h>
#include <glib-object.h>
typedef struct {
GObject something_as_boilerplate;
char *name;
} myinstance_t;
typedef struct {
GObjectClass something_as_boilerplate;
} myclass_t;
GType get_my_typeid();
void my_instance_init_func(myinstance_t *instance, gpointer data) {
instance->name = "AnInstance";
}
void my_class_init_func(myclass_t* klass, gpointer data) {
int signal_id = g_signal_new(
"my-signal",
get_my_typeid(),
G_SIGNAL_RUN_LAST,
0,
NULL,
NULL,
g_cclosure_marshal_VOID__STRING,
G_TYPE_NONE,
1,
G_TYPE_STRING,
NULL
);
}
GType get_my_typeid() {
static my_type_id = 0;
if(my_type_id==0) {
GTypeInfo my_type_info = {
sizeof(myclass_t), //class_size;
NULL, //base_init;
NULL, //base_finalize;
/* classed types, instantiated types */
(GClassInitFunc)my_class_init_func, //class_init;
NULL, //class_finalize;
NULL, //class_data;
/* instantiated types */
sizeof(myinstance_t),//instance_size;
0, //n_preallocs;
(GInstanceInitFunc)my_instance_init_func, //instance_init;
/* value handling */
NULL, //value_table;
};
my_type_id = g_type_register_static(
G_TYPE_OBJECT,
"MyClass",
&my_type_info,
0
);
}
return my_type_id;
}
void hello(GObject *sender, char* name, gpointer data) {
printf("Hello world, [%s]!
",name);
}
void goodbye(GObject *sender, char* name, gpointer data) {
myinstance_t *instance = G_TYPE_CHECK_INSTANCE_CAST(
sender,get_my_typeid(),myinstance_t);
printf("Goodbye world, [%s]! Message from [%s]. data is [%d]
",
name, instance->name, *(int*)data);
}
int main() {
g_type_init();
printf("Type id: %d
",get_my_typeid());
printf("Type name: %s
",g_type_name(get_my_typeid()));
GValue *val = g_new0(GValue,1);
// the first object
myinstance_t *instance = (myinstance_t*)g_object_new(get_my_typeid(),NULL);
int tmpvar = 42;
g_signal_connect(instance,"my-signal",G_CALLBACK(hello),NULL);
g_signal_connect(instance,"my-signal",G_CALLBACK(goodbye),&tmpvar);
g_signal_emit_by_name(instance,"my-signal","cloverprince");
g_object_unref(instance);
g_free(val);
return 0;
}
A signal is created using g_signal_new.
void my_class_init_func(myclass_t* klass, gpointer data) {
int signal_id = g_signal_new(
"my-signal",
get_my_typeid(),
G_SIGNAL_RUN_LAST,
0,
NULL,
NULL,
g_cclosure_marshal_VOID__STRING,
G_TYPE_NONE,
1,
G_TYPE_STRING,
NULL
);
}
You need a name for it. It should be a combination of lower-case letters and hyphens ('-'). You also need to specify the class it associtated to. Then you tell it the type of the parameters as well as the return value of the signal handler.
A GSignalCMarshaller is required. It is specific to each combination of parameter types and return-value type. There are many such marshaller functions provided by default. If there is not one for yours, you can create one with the glib-genmarshal command-line utility.
Signals are connected to functions with g_signal_connect and emitted with g_signal_emit or g_signal_emit_by_name.
Note that the first parameter of each signal handler function is always a GObject pointer pointing to the object which emitted the signal. The last parameter is the custom data provided in g_signal_connedt. The parameters in between are those specified in g_signal_new.