GIArgInfo *info
);
-gboolean g_arg_info_is_caller_allocates (GIArgInfo *info
);
-gboolean g_arg_info_is_return_value (GIArgInfo *info
);
-gboolean g_arg_info_is_optional (GIArgInfo *info
);
-gboolean g_arg_info_may_be_null (GIArgInfo *info
);
+gboolean g_arg_info_is_caller_allocates (GIArgInfo *info
);
+gboolean g_arg_info_is_return_value (GIArgInfo *info
);
+gboolean g_arg_info_is_optional (GIArgInfo *info
);
+gboolean g_arg_info_may_be_null (GIArgInfo *info
);
GITransfer g_arg_info_get_ownership_transfer (GIArgInfo *info
);
GIScopeType g_arg_info_get_scope (GIArgInfo *info
);
-gint g_arg_info_get_closure (GIArgInfo *info
);
-gint g_arg_info_get_destroy (GIArgInfo *info
);
+gint g_arg_info_get_closure (GIArgInfo *info
);
+gint g_arg_info_get_destroy (GIArgInfo *info
);
GITypeInfo * g_arg_info_get_type (GIArgInfo *info
);
void g_arg_info_load_type (GIArgInfo *info
,
GITypeInfo *type
);
@@ -214,7 +214,7 @@
g_list_free()
/g_hash_table_destroy()
etc) of this transfer.
+(g_list_free()
/g_hash_table_destroy()
etc) of this transfer.
gboolean g_arg_info_is_caller_allocates (GIArgInfo *info
);
+gboolean g_arg_info_is_caller_allocates (GIArgInfo *info
);
Obtain if the argument is a pointer to a struct or object that will
receive an output of a function. The default assumption for
GI_DIRECTION_OUT
arguments which have allocation is that the
-callee allocates; if this is TRUE
, then the caller must allocate.
+callee allocates; if this is TRUE
, then the caller must allocate.
Returns : |
- TRUE if caller is required to have allocated the argument
+ | TRUE if caller is required to have allocated the argument
|
Returns : |
- TRUE if it is a return value
+ | TRUE if it is a return value
|
Returns : |
- TRUE if it is an optional argument
+ | TRUE if it is an optional argument
|
Returns : |
- TRUE if it accepts NULL
+ | TRUE if it accepts NULL
|
Returns : |
-index of the GDestroyNotify argument or -1 if there is none + | index of the GDestroyNotify argument or -1 if there is none |
1 +2 |
+ GIFunctionInfo *function_info = ...; +GIBaseInfo *info = (GIBaseInfo*)function_info; |
+
Most GIRepository APIs returning a GIBaseInfo is actually creating a new struct, in other
@@ -81,12 +90,22 @@
Example 2. Getting the Button of the Gtk typelib
-- GIBaseInfo *button_info = g_irepository_find_by_name(NULL, "Gtk", "Button"); - ... use button_info ... - g_base_info_unref(button_info); -
Example 2. Getting the Button of the Gtk typelib
+1 +2 +3 |
+ GIBaseInfo *button_info = g_irepository_find_by_name(NULL, "Gtk", "Button"); +... use button_info ... +g_base_info_unref(button_info); |
+
const gchar * g_base_info_get_name (GIBaseInfo *info
);
+const gchar * g_base_info_get_name (GIBaseInfo *info
);
Obtain the name of the info
. What the name represents depends on
the GIInfoType of the info
. For instance for GIFunctionInfo it is
@@ -348,7 +367,7 @@
Returns :
info
or NULL
if it lacks a name.
+info
or NULL
if it lacks a name.
const gchar * g_base_info_get_namespace (GIBaseInfo *info
);
+const gchar * g_base_info_get_namespace (GIBaseInfo *info
);
Obtain the namespace of info
.
gboolean g_base_info_is_deprecated (GIBaseInfo *info
);
+gboolean g_base_info_is_deprecated (GIBaseInfo *info
);
Obtain whether the info
is represents a metadata which is
deprecated or not.
@@ -395,7 +414,7 @@
Returns :
TRUE
if deprecated
+TRUE
if deprecated
const gchar * g_base_info_get_attribute (+GIBaseInfo *info
, -const gchar *name
);
const gchar * g_base_info_get_attribute (GIBaseInfo *info
, +const gchar *name
);
Retrieve an arbitrary attribute associated with this node.
@@ -424,7 +443,7 @@Returns :
NULL
if no such attribute exists
+NULL
if no such attribute exists
gboolean g_base_info_iterate_attributes (GIBaseInfo *info
, +gboolean g_base_info_iterate_attributes (GIBaseInfo *info
,GIAttributeIter *iterator
,char **name
,char **value
);Iterate over all attributes associated with this node. The iterator structure is typically stack allocated, and must have its first -member initialized to
NULL
. +member initialized toNULL
.Both the
name
andvalue
should be treated as constants @@ -449,20 +468,38 @@
-Example 3. Iterating over attributes
-+-void -print_attributes (GIBaseInfo *info) -{ - GIAttributeIter iter = { 0, }; - char *name; - char *value; - while (g_base_info_iterate_attributes (info, &iter, &name, &value)) - { - g_print ("attribute name: %s value: %s", name, value); - } -} -Example 3. Iterating over attributes
++++ +
++ + ++ 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11+ void +print_attributes (GIBaseInfo *info) +{ + GIAttributeIter iter = { 0, }; + char *name; + char *value; + while (g_base_info_iterate_attributes (info, &iter, &name, &value)) + { + g_print ("attribute name: %s value: %s", name, value); + } +}@@ -491,7 +528,7 @@
@@ -548,7 +585,7 @@ - Returns :
TRUE
if there are more attributes +TRUE
if there are more attributes
g_base_info_equal ()
-gboolean g_base_info_equal (GIBaseInfo *info1
, +gboolean g_base_info_equal (GIBaseInfo *info1
,GIBaseInfo *info2
);Compare two GIBaseInfo. @@ -573,7 +610,7 @@
diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GICallableInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GICallableInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GICallableInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GICallableInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -41,20 +41,20 @@ typedef GICallableInfo; GITypeInfo * g_callable_info_get_return_type ( - Returns :
TRUE
if and only ifinfo1
equalsinfo2
. +TRUE
if and only ifinfo1
equalsinfo2
.GICallableInfo *info
); GITransfer g_callable_info_get_caller_owns (GICallableInfo *info
); -gboolean g_callable_info_may_return_null (GICallableInfo *info
); -const gchar * g_callable_info_get_return_attribute +gboolean g_callable_info_may_return_null (GICallableInfo *info
); +const gchar * g_callable_info_get_return_attribute (GICallableInfo *info
, -const gchar *name
); -gboolean g_callable_info_iterate_return_attributes +const gchar *name
); +gboolean g_callable_info_iterate_return_attributes (GICallableInfo *info
,GIAttributeIter *iterator
,char **name
,char **value
); -gint g_callable_info_get_n_args (GICallableInfo *info
); +gint g_callable_info_get_n_args (GICallableInfo *info
); GIArgInfo * g_callable_info_get_arg (GICallableInfo *info
, -gint n
); +gint n
); void g_callable_info_load_arg (GICallableInfo *info
, -gint n
, +gint n
,GIArgInfo *arg
); void g_callable_info_load_return_type (GICallableInfo *info
,GITypeInfo *type
); @@ -154,7 +154,7 @@@@ -163,9 +163,9 @@ - Returns :
TRUE
if the caller owns the return value,FALSE
otherwise. +TRUE
if the caller owns the return value,FALSE
otherwise.
g_callable_info_may_return_null ()
-gboolean g_callable_info_may_return_null (+GICallableInfo *info
);gboolean g_callable_info_may_return_null (GICallableInfo *info
);-See if a callable could return
NULL
. +See if a callable could returnNULL
.
@@ -177,7 +177,7 @@ @@ -186,9 +186,9 @@ - Returns :
TRUE
if callable could returnNULL
+TRUE
if callable could returnNULL
g_callable_info_get_return_attribute ()
-const gchar * g_callable_info_get_return_attribute +const gchar * g_callable_info_get_return_attribute (+GICallableInfo *info
, -const gchar *name
);const gchar *name
);Retrieve an arbitrary attribute associated with the return value.
@@ -207,7 +207,7 @@@@ -216,7 +216,7 @@ - Returns :
The value of the attribute, or NULL
if no such attribute exists +The value of the attribute, or NULL
if no such attribute exists
g_callable_info_iterate_return_attributes ()
-gboolean g_callable_info_iterate_return_attributes +gboolean g_callable_info_iterate_return_attributes (GICallableInfo *info
,GIAttributeIter *iterator
,char **name
, @@ -224,7 +224,7 @@Iterate over all attributes associated with the return value. The iterator structure is typically stack allocated, and must have its -first member initialized to
NULL
. +first member initialized toNULL
.Both the
name
andvalue
should be treated as constants @@ -259,7 +259,7 @@@@ -268,7 +268,7 @@ - Returns :
TRUE
if there are more attributes +TRUE
if there are more attributes
g_callable_info_get_n_args ()
-gint g_callable_info_get_n_args (+GICallableInfo *info
);gint g_callable_info_get_n_args (GICallableInfo *info
);Obtain the number of arguments (both IN and OUT) for this callable.
@@ -292,7 +292,7 @@g_callable_info_get_arg ()
GIArgInfo * g_callable_info_get_arg (+GICallableInfo *info
, -gint n
);gint n
);Obtain information about a particular argument of this callable.
@@ -322,7 +322,7 @@@@ -115,7 +115,7 @@g_callable_info_load_arg ()
void g_callable_info_load_arg (GICallableInfo *info
, -gint n
, +gint n
,GIArgInfo *arg
);Obtain information about a particular argument of this callable; this diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIConstantInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIConstantInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIConstantInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIConstantInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -40,7 +40,7 @@
#define GI_IS_CONSTANT_INFO (info) typedef GIConstantInfo; GITypeInfo * g_constant_info_get_type (GIConstantInfo *info
); -gint g_constant_info_get_value (GIConstantInfo *info
, +gint g_constant_info_get_value (GIConstantInfo *info
,GArgument *value
);
g_constant_info_get_value ()
-gint g_constant_info_get_value (GIConstantInfo *info
, +gint g_constant_info_get_value (GIConstantInfo *info
,GArgument *value
);Obtain the value associated with the GIConstantInfo and store it in the diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIEnumInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIEnumInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIEnumInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIEnumInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -41,11 +41,11 @@ #define GI_IS_VALUE_INFO (info) typedef GIEnumInfo; typedef GIValueInfo; -gint g_enum_info_get_n_values (
GIEnumInfo *info
); +gint g_enum_info_get_n_values (GIEnumInfo *info
); GIValueInfo * g_enum_info_get_value (GIEnumInfo *info
, -gint n
); +gint n
); GITypeTag g_enum_info_get_storage_type (GIEnumInfo *info
); -glong g_value_info_get_value (GIValueInfo *info
); +glong g_value_info_get_value (GIValueInfo *info
);@@ -120,7 +120,7 @@
g_enum_info_get_n_values ()
-gint g_enum_info_get_n_values (+GIEnumInfo *info
);gint g_enum_info_get_n_values (GIEnumInfo *info
);Obtain the number of values this enumeration contains.
@@ -144,7 +144,7 @@g_enum_info_get_value ()
GIValueInfo * g_enum_info_get_value (+GIEnumInfo *info
, -gint n
);gint n
);Obtain a value for this enumeration.
@@ -163,7 +163,7 @@@@ -202,7 +202,7 @@ - Returns :
the enumeration value or NULL
if type tag is wrong, +the enumeration value or NULL
if type tag is wrong, free the struct withg_base_info_unref()
when done. [transfer full]
g_value_info_get_value ()
-glong g_value_info_get_value (+GIValueInfo *info
);glong g_value_info_get_value (GIValueInfo *info
);Obtain the enumeration value of the GIValueInfo.
diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIErrorDomainInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIErrorDomainInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIErrorDomainInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIErrorDomainInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -39,15 +39,15 @@Synopsis
#define GI_IS_ERROR_DOMAIN_INFO (info) typedef GIErrorDomainInfo; -const gchar * g_error_domain_info_get_quark (GIErrorDomainInfo *info
); +const gchar * g_error_domain_info_get_quark (GIErrorDomainInfo *info
); GIInterfaceInfo * g_error_domain_info_get_codes (GIErrorDomainInfo *info
);Description
-A GIErrorDomainInfo struct represents a domain of a GError. -An error domain is associated with a GQuark and contains a pointer +A GIErrorDomainInfo struct represents a domain of a GError. +An error domain is associated with a GQuark and contains a pointer to an enum with all the error codes.
@@ -84,16 +84,16 @@
typedef GIBaseInfo GIErrorDomainInfo;-Represents a GError error domain. +Represents a GError error domain.
g_error_domain_info_get_quark ()
-const gchar * g_error_domain_info_get_quark (+GIErrorDomainInfo *info
);const gchar * g_error_domain_info_get_quark (GIErrorDomainInfo *info
);Obtain a string representing the quark for this error domain. -
NULL
will be returned if the type tag is wrong or if a quark is +NULL
will be returned if the type tag is wrong or if a quark is missing in the typelib.@@ -106,7 +106,7 @@
@@ -130,7 +130,7 @@ - Returns :
the quark represented as a string or NULL
+the quark represented as a string or NULL
diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIFieldInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIFieldInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIFieldInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIFieldInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -41,14 +41,14 @@ typedef GIFieldInfo; enum GIFieldInfoFlags; GIFieldInfoFlags g_field_info_get_flags ( - Returns :
the error domain or NULL
if type tag is wrong, +the error domain or NULL
if type tag is wrong, free the struct withg_base_info_unref()
when done. [transfer full]GIFieldInfo *info
); -gint g_field_info_get_size (GIFieldInfo *info
); -gint g_field_info_get_offset (GIFieldInfo *info
); +gint g_field_info_get_size (GIFieldInfo *info
); +gint g_field_info_get_offset (GIFieldInfo *info
); GITypeInfo * g_field_info_get_type (GIFieldInfo *info
); -gboolean g_field_info_get_field (GIFieldInfo *field_info
, -gpointer mem
, +gboolean g_field_info_get_field (GIFieldInfo *field_info
, +gpointer mem
,GArgument *value
); -gboolean g_field_info_set_field (GIFieldInfo *field_info
, -gpointer mem
, +gboolean g_field_info_set_field (GIFieldInfo *field_info
, +gpointer mem
,const GArgument *value
); @@ -154,7 +154,7 @@
g_field_info_get_size ()
-gint g_field_info_get_size (+GIFieldInfo *info
);gint g_field_info_get_size (GIFieldInfo *info
);Obtain the size in bits of the field member, this is how much space you need to allocate to store the field. @@ -178,7 +178,7 @@
g_field_info_get_offset ()
-gint g_field_info_get_offset (+GIFieldInfo *info
);gint g_field_info_get_offset (GIFieldInfo *info
);Obtain the offset in bits of the field member, this is relative to the beginning of the struct or union. @@ -226,8 +226,8 @@
g_field_info_get_field ()
-gboolean g_field_info_get_field (GIFieldInfo *field_info
, -gpointer mem
, +gboolean g_field_info_get_field (GIFieldInfo *field_info
, +gpointer mem
,GArgument *value
);Reads a field identified by a GFieldInfo from a C structure or @@ -255,7 +255,7 @@
@@ -264,8 +264,8 @@ - Returns :
TRUE
if reading the field succeeded, otherwiseFALSE
+TRUE
if reading the field succeeded, otherwiseFALSE
g_field_info_set_field ()
-gboolean g_field_info_set_field (GIFieldInfo *field_info
, -gpointer mem
, +gboolean g_field_info_set_field (GIFieldInfo *field_info
, +gpointer mem
,const GArgument *value
);Writes a field identified by a GFieldInfo to a C structure or @@ -295,7 +295,7 @@
diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIFunctionInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIFunctionInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIFunctionInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIFunctionInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -42,17 +42,17 @@ enum GInvokeError; enum GIFunctionInfoFlags; #define G_INVOKE_ERROR -const gchar * g_function_info_get_symbol ( - Returns :
TRUE
if writing the field succeeded, otherwiseFALSE
+TRUE
if writing the field succeeded, otherwiseFALSE
GIFunctionInfo *info
); +const gchar * g_function_info_get_symbol (GIFunctionInfo *info
); GIFunctionInfoFlags g_function_info_get_flags (GIFunctionInfo *info
); GIPropertyInfo * g_function_info_get_property (GIFunctionInfo *info
); GIVFuncInfo * g_function_info_get_vfunc (GIFunctionInfo *info
); -gboolean g_function_info_invoke (GIFunctionInfo *info
, +gboolean g_function_info_invoke (GIFunctionInfo *info
,const GArgument *in_args
,int n_in_args
,const GArgument *out_args
,int n_out_args
,GArgument *return_value
, -GError **error
); +GError **error
);@@ -206,11 +206,11 @@
g_function_info_get_symbol ()
-const gchar * g_function_info_get_symbol (+GIFunctionInfo *info
);const gchar * g_function_info_get_symbol (GIFunctionInfo *info
);Obtain the symbol of the function. The symbol is the name of the exported function, suitable to be used as an argument to -
g_module_symbol()
. +g_module_symbol()
.
@@ -259,7 +259,7 @@ Obtain the property associated with this GIFunctionInfo. Only GIFunctionInfo with the flag GI_FUNCTION_IS_GETTER
orGI_FUNCTION_IS_SETTER
have a property set. For other cases, -NULL
will be returned. +NULL
will be returned.
@@ -271,7 +271,7 @@ @@ -285,7 +285,7 @@ - Returns :
the property or NULL
if not set. Free it with +the property or NULL
if not set. Free it withg_base_info_unref()
when done. [transfer full]Obtain the virtual function associated with this GIFunctionInfo. Only GIFunctionInfo with the flag
GI_FUNCTION_WRAPS_VFUNC
has -a virtual function set. For other cases,NULL
will be returned. +a virtual function set. For other cases,NULL
will be returned.
@@ -297,7 +297,7 @@ @@ -307,20 +307,20 @@ - Returns :
the virtual function or NULL
if not set. +the virtual function or NULL
if not set. Free it by callingg_base_info_unref()
when done. [transfer full]
g_function_info_invoke ()
-gboolean g_function_info_invoke (GIFunctionInfo *info
, +gboolean g_function_info_invoke (+GIFunctionInfo *info
,const GArgument *in_args
,int n_in_args
,const GArgument *out_args
,int n_out_args
,GArgument *return_value
, -GError **error
);GError **error
);Invokes the function described in
info
with the given arguments. Note that inout parameters must appear in both argument lists. This function usesdlsym()
to obtain a pointer to the function, so the library or shared object containing the described function must either be linked to the caller, or must -have beeng_module_symbol()
ed before calling this function. +have beeng_module_symbol()
ed before calling this function.
@@ -334,7 +334,7 @@
in_args
 :an array of GArguments, one for each in parameter of info
. If there are no in parameter,in_args
- can beNULL
+ can beNULL
@@ -346,7 +346,7 @@
out_args
 :an array of GArguments, one for each out parameter of info
. If there are no out parameters,out_args
- may beNULL
+ may beNULL
@@ -358,17 +358,17 @@
return_value
 :return location for the return value of the function. If the function returns void, return_value
may be -NULL
+NULL
-
error
 :return location for detailed error information, or NULL
+return location for detailed error information, or NULL
diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIInterfaceInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIInterfaceInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIInterfaceInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIInterfaceInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -39,30 +39,30 @@ - Returns :
TRUE
if the function has been invoked,FALSE
if an +TRUE
if the function has been invoked,FALSE
if an error occurred.Synopsis
#define GI_IS_INTERFACE_INFO (info) typedef GIInterfaceInfo; -gint g_interface_info_get_n_prerequisites +gint g_interface_info_get_n_prerequisites (GIInterfaceInfo *info
); GIBaseInfo * g_interface_info_get_prerequisite (GIInterfaceInfo *info
, -gint n
); -gint g_interface_info_get_n_properties (GIInterfaceInfo *info
); +gint n
); +gint g_interface_info_get_n_properties (GIInterfaceInfo *info
); GIPropertyInfo * g_interface_info_get_property (GIInterfaceInfo *info
, -gint n
); -gint g_interface_info_get_n_methods (GIInterfaceInfo *info
); +gint n
); +gint g_interface_info_get_n_methods (GIInterfaceInfo *info
); GIFunctionInfo * g_interface_info_get_method (GIInterfaceInfo *info
, -gint n
); +gint n
); GIFunctionInfo * g_interface_info_find_method (GIInterfaceInfo *info
, -const gchar *name
); -gint g_interface_info_get_n_signals (GIInterfaceInfo *info
); +const gchar *name
); +gint g_interface_info_get_n_signals (GIInterfaceInfo *info
); GISignalInfo * g_interface_info_get_signal (GIInterfaceInfo *info
, -gint n
); -gint g_interface_info_get_n_vfuncs (GIInterfaceInfo *info
); +gint n
); +gint g_interface_info_get_n_vfuncs (GIInterfaceInfo *info
); GIVFuncInfo * g_interface_info_get_vfunc (GIInterfaceInfo *info
, -gint n
); -gint g_interface_info_get_n_constants (GIInterfaceInfo *info
); +gint n
); +gint g_interface_info_get_n_constants (GIInterfaceInfo *info
); GIConstantInfo * g_interface_info_get_constant (GIInterfaceInfo *info
, -gint n
); +gint n
); GIStructInfo * g_interface_info_get_iface_struct (GIInterfaceInfo *info
); GIVFuncInfo * g_interface_info_find_vfunc (GIInterfaceInfo *info
, -const gchar *name
); +const gchar *name
);@@ -115,7 +115,7 @@
g_interface_info_get_n_prerequisites ()
-gint g_interface_info_get_n_prerequisites +gint g_interface_info_get_n_prerequisites (GIInterfaceInfo *info
);Obtain the number of prerequisites for this interface type. @@ -142,7 +142,7 @@
g_interface_info_get_prerequisite ()
GIBaseInfo * g_interface_info_get_prerequisite (+GIInterfaceInfo *info
, -gint n
);gint n
);Obtain an interface type prerequisites index
@@ -171,7 +171,7 @@n
.
g_interface_info_get_n_properties ()
-gint g_interface_info_get_n_properties (+GIInterfaceInfo *info
);gint g_interface_info_get_n_properties (GIInterfaceInfo *info
);Obtain the number of properties that this interface type has.
@@ -195,7 +195,7 @@g_interface_info_get_property ()
GIPropertyInfo * g_interface_info_get_property (+GIInterfaceInfo *info
, -gint n
);gint n
);Obtain an interface type property at index
@@ -224,7 +224,7 @@n
.
g_interface_info_get_n_methods ()
-gint g_interface_info_get_n_methods (+GIInterfaceInfo *info
);gint g_interface_info_get_n_methods (GIInterfaceInfo *info
);Obtain the number of methods that this interface type has.
@@ -248,7 +248,7 @@g_interface_info_get_method ()
GIFunctionInfo * g_interface_info_get_method (+GIInterfaceInfo *info
, -gint n
);gint n
);Obtain an interface type method at index
@@ -278,9 +278,9 @@n
.+g_interface_info_find_method ()
GIFunctionInfo * g_interface_info_find_method (+GIInterfaceInfo *info
, -const gchar *name
);const gchar *name
);-Obtain a method of the interface type given a
name
.NULL
will be +Obtain a method of the interface type given aname
.NULL
will be returned if there's no method available with that name.+@@ -298,7 +298,7 @@
@@ -308,7 +308,7 @@ - Returns :
the GIFunctionInfo or NULL
if none found. +the GIFunctionInfo or NULL
if none found. Free the struct by callingg_base_info_unref()
when done. [transfer full]
g_interface_info_get_n_signals ()
-gint g_interface_info_get_n_signals (+GIInterfaceInfo *info
);gint g_interface_info_get_n_signals (GIInterfaceInfo *info
);Obtain the number of signals that this interface type has.
@@ -332,7 +332,7 @@g_interface_info_get_signal ()
GISignalInfo * g_interface_info_get_signal (+GIInterfaceInfo *info
, -gint n
);gint n
);Obtain an interface type signal at index
@@ -361,7 +361,7 @@n
.
g_interface_info_get_n_vfuncs ()
-gint g_interface_info_get_n_vfuncs (+GIInterfaceInfo *info
);gint g_interface_info_get_n_vfuncs (GIInterfaceInfo *info
);Obtain the number of virtual functions that this interface type has.
@@ -385,7 +385,7 @@g_interface_info_get_vfunc ()
GIVFuncInfo * g_interface_info_get_vfunc (+GIInterfaceInfo *info
, -gint n
);gint n
);Obtain an interface type virtual function at index
@@ -414,7 +414,7 @@n
.
g_interface_info_get_n_constants ()
-gint g_interface_info_get_n_constants (+GIInterfaceInfo *info
);gint g_interface_info_get_n_constants (GIInterfaceInfo *info
);Obtain the number of constants that this interface type has.
@@ -438,7 +438,7 @@g_interface_info_get_constant ()
GIConstantInfo * g_interface_info_get_constant (+GIInterfaceInfo *info
, -gint n
);gint n
);Obtain an interface type constant at index
@@ -481,7 +481,7 @@n
.@@ -492,7 +492,7 @@ - Returns :
the GIStructInfo or NULL
. Free it with +the GIStructInfo or NULL
. Free it withg_base_info_unref()
when done. [transfer full]g_interface_info_find_vfunc ()
GIVFuncInfo * g_interface_info_find_vfunc (+GIInterfaceInfo *info
, -const gchar *name
);const gchar *name
);Locate a virtual function slot with name
name
. See the documentation forg_object_info_find_vfunc()
for more information on virtuals. @@ -512,7 +512,7 @@diff -Nru gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIObjectInfo.html gobject-introspection-0.9.2/docs/reference/html/gi-GIObjectInfo.html --- gobject-introspection-0.9.1~git20100708.01772763/docs/reference/html/gi-GIObjectInfo.html 2010-07-09 11:39:12.000000000 +0100 +++ gobject-introspection-0.9.2/docs/reference/html/gi-GIObjectInfo.html 2010-07-12 18:21:51.000000000 +0100 @@ -39,42 +39,62 @@ - Returns :
the GIVFuncInfo, or NULL
. Free it with +the GIVFuncInfo, or NULL
. Free it withg_base_info_unref()
when done. [transfer full]Synopsis
#define GI_IS_OBJECT_INFO (info) typedef GIObjectInfo; -const gchar * g_object_info_get_type_name (GIObjectInfo *info
); -const gchar * g_object_info_get_type_init (GIObjectInfo *info
); -gboolean g_object_info_get_abstract (GIObjectInfo *info
); +void * (*GIObjectInfoGetValueFunction) (const GValue *value
); +void * (*GIObjectInfoRefFunction) (void *object
); +void (*GIObjectInfoSetValueFunction) (GValue *value
, +void *object
); +void (*GIObjectInfoUnrefFunction) (void *object
); +const gchar * g_object_info_get_type_name (GIObjectInfo *info
); +const gchar * g_object_info_get_type_init (GIObjectInfo *info
); +gboolean g_object_info_get_abstract (GIObjectInfo *info
); +gboolean g_object_info_get_fundamental (GIObjectInfo *info
); GIObjectInfo * g_object_info_get_parent (GIObjectInfo *info
); -gint g_object_info_get_n_interfaces (GIObjectInfo *info
); +gint g_object_info_get_n_interfaces (GIObjectInfo *info
); GIInterfaceInfo * g_object_info_get_interface (GIObjectInfo *info
, -gint n
); -gint g_object_info_get_n_fields (GIObjectInfo *info
); +gint n
); +gint g_object_info_get_n_fields (GIObjectInfo *info
); GIFieldInfo * g_object_info_get_field (GIObjectInfo *info
, -gint n
); -gint g_object_info_get_n_properties (GIObjectInfo *info
); +gint n
); +gint g_object_info_get_n_properties (GIObjectInfo *info
); GIPropertyInfo * g_object_info_get_property (GIObjectInfo *info
, -gint n
); -gint g_object_info_get_n_methods (GIObjectInfo *info
); +gint n
); +gint g_object_info_get_n_methods (GIObjectInfo *info
); GIFunctionInfo * g_object_info_get_method (GIObjectInfo *info
, -gint n
); +gint n
); GIFunctionInfo * g_object_info_find_method (GIObjectInfo *info
, -const gchar *name
); -gint g_object_info_get_n_signals (GIObjectInfo *info
); +const gchar *name
); +gint g_object_info_get_n_signals (GIObjectInfo *info
); GISignalInfo * g_object_info_get_signal (GIObjectInfo *info
, -gint n
); -gint g_object_info_get_n_vfuncs (GIObjectInfo *info
); +gint n
); +gint g_object_info_get_n_vfuncs (GIObjectInfo *info
); GIVFuncInfo * g_object_info_get_vfunc (GIObjectInfo *info
, -gint n
); -gint g_object_info_get_n_constants (GIObjectInfo *info
); +gint n
); +gint g_object_info_get_n_constants (GIObjectInfo *info
); GIConstantInfo * g_object_info_get_constant (GIObjectInfo *info
, -gint n
); +gint n
); GIStructInfo * g_object_info_get_class_struct (GIObjectInfo *info
); GIVFuncInfo * g_object_info_find_vfunc (GIObjectInfo *info
, -const gchar *name
); +const gchar *name
); +const char * g_object_info_get_unref_function (GIObjectInfo *info
); +GIObjectInfoUnrefFunction g_object_info_get_unref_function_pointer + (GIObjectInfo *info
); +const char * g_object_info_get_ref_function (GIObjectInfo *info
); +GIObjectInfoRefFunction g_object_info_get_ref_function_pointer + (GIObjectInfo *info
); +const char * g_object_info_get_set_value_function + (GIObjectInfo *info
); +GIObjectInfoSetValueFunction g_object_info_get_set_value_function_pointer + (GIObjectInfo *info
); +const char * g_object_info_get_get_value_function + (GIObjectInfo *info
); +GIObjectInfoGetValueFunction g_object_info_get_get_value_function_pointer + (GIObjectInfo *info
);Description
-GIObjectInfo represents a GObject. This doesn't represent a specific +GIObjectInfo represents a GObject. This doesn't represent a specific instance of a GObject, instead this represent the object type (eg class).
@@ -120,9 +140,95 @@
+++GIObjectInfoGetValueFunction ()
+void * (*GIObjectInfoGetValueFunction) (+const GValue *value
);+Extract an object instance out of
+value
+++
+ + + ++
value
 :a GValue + ++ + ++ Returns :
the object instance + +
+++GIObjectInfoRefFunction ()
+void * (*GIObjectInfoRefFunction) (+void *object
);+Increases the reference count of an object instance. +
+++
+ + + ++
object
 :object instance pointer + ++ + ++ Returns :
the object instance + +
+++GIObjectInfoSetValueFunction ()
+void (*GIObjectInfoSetValueFunction) (+GValue *value
, +void *object
);+Update
+value
and attach the object instance pointerobject
to it. +++
+ + + ++
value
 :a GValue + ++ + ++
object
 :object instance pointer + +
+++GIObjectInfoUnrefFunction ()
+void (*GIObjectInfoUnrefFunction) (+void *object
);+Decreases the reference count of an object instance. +
+++
+ + ++
object
 :object instance pointer + +
g_object_info_get_type_name ()
-const gchar * g_object_info_get_type_name (+GIObjectInfo *info
);const gchar * g_object_info_get_type_name (GIObjectInfo *info
);Obtain the name of the objects class/type.
@@ -145,7 +251,7 @@
g_object_info_get_type_init ()
-const gchar * g_object_info_get_type_init (+GIObjectInfo *info
);const gchar * g_object_info_get_type_init (GIObjectInfo *info
);Obtain the function which when called will return the GType function for which this object type is registered. @@ -169,7 +275,7 @@
g_object_info_get_abstract ()
-gboolean g_object_info_get_abstract (+GIObjectInfo *info
);gboolean g_object_info_get_abstract (GIObjectInfo *info
);Obtain if the object type is an abstract type, eg if it cannot be instantiated @@ -184,7 +290,31 @@
+ + - Returns :
TRUE
if the object type is abstract ++ TRUE
if the object type is abstract +
++g_object_info_get_fundamental ()
+gboolean g_object_info_get_fundamental (+GIObjectInfo *info
);+Obtain if the object type is of a fundamental type which is not +G_TYPE_OBJECT. This is mostly for supporting GstMiniObject. +
++
+ + + ++
info
 :a GIObjectInfo + ++ @@ -217,7 +347,7 @@+ Returns :
TRUE
if the object type is a fundamental type
g_object_info_get_n_interfaces ()
-gint g_object_info_get_n_interfaces (+GIObjectInfo *info
);gint g_object_info_get_n_interfaces (GIObjectInfo *info
);Obtain the number of interfaces that this object type has.
@@ -241,7 +371,7 @@g_object_info_get_interface ()
GIInterfaceInfo * g_object_info_get_interface (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type interface at index
@@ -270,7 +400,7 @@n
.
g_object_info_get_n_fields ()
-gint g_object_info_get_n_fields (+GIObjectInfo *info
);gint g_object_info_get_n_fields (GIObjectInfo *info
);Obtain the number of fields that this object type has.
@@ -294,7 +424,7 @@g_object_info_get_field ()
GIFieldInfo * g_object_info_get_field (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type field at index
@@ -323,7 +453,7 @@n
.
g_object_info_get_n_properties ()
-gint g_object_info_get_n_properties (+GIObjectInfo *info
);gint g_object_info_get_n_properties (GIObjectInfo *info
);Obtain the number of properties that this object type has.
@@ -347,7 +477,7 @@g_object_info_get_property ()
GIPropertyInfo * g_object_info_get_property (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type property at index
@@ -376,7 +506,7 @@n
.
g_object_info_get_n_methods ()
-gint g_object_info_get_n_methods (+GIObjectInfo *info
);gint g_object_info_get_n_methods (GIObjectInfo *info
);Obtain the number of methods that this object type has.
@@ -400,7 +530,7 @@g_object_info_get_method ()
GIFunctionInfo * g_object_info_get_method (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type method at index
@@ -430,9 +560,9 @@n
.g_object_info_find_method ()
GIFunctionInfo * g_object_info_find_method (+GIObjectInfo *info
, -const gchar *name
);const gchar *name
);-Obtain a method of the object type given a
name
.NULL
will be +Obtain a method of the object type given aname
.NULL
will be returned if there's no method available with that name.@@ -460,7 +590,7 @@
g_object_info_get_n_signals ()
-gint g_object_info_get_n_signals (+GIObjectInfo *info
);gint g_object_info_get_n_signals (GIObjectInfo *info
);Obtain the number of signals that this object type has.
@@ -484,7 +614,7 @@g_object_info_get_signal ()
GISignalInfo * g_object_info_get_signal (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type signal at index
@@ -513,7 +643,7 @@n
.
g_object_info_get_n_vfuncs ()
-gint g_object_info_get_n_vfuncs (+GIObjectInfo *info
);gint g_object_info_get_n_vfuncs (GIObjectInfo *info
);Obtain the number of virtual functions that this object type has.
@@ -537,7 +667,7 @@g_object_info_get_vfunc ()
GIVFuncInfo * g_object_info_get_vfunc (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type virtual function at index
@@ -566,7 +696,7 @@n
.
g_object_info_get_n_constants ()
-gint g_object_info_get_n_constants (+GIObjectInfo *info
);gint g_object_info_get_n_constants (GIObjectInfo *info
);Obtain the number of constants that this object type has.
@@ -590,7 +720,7 @@+g_object_info_get_constant ()
GIConstantInfo * g_object_info_get_constant (+GIObjectInfo *info
, -gint n
);gint n
);Obtain an object type constant at index
@@ -621,7 +751,7 @@n
.g_object_info_get_class_struct ()
GIStructInfo * g_object_info_get_class_struct (GIObjectInfo *info
);-Every GObject has two structures; an instance structure and a class +Every GObject has two structures; an instance structure and a class structure. This function returns the metadata for the class structure.
@@ -634,7 +764,7 @@
@@ -645,12 +775,12 @@ - Returns :
the GIStructInfo or NULL
. Free with +the GIStructInfo or NULL
. Free withg_base_info_unref()
when done. [transfer full]g_object_info_find_vfunc ()
GIVFuncInfo * g_object_info_find_vfunc (+GIObjectInfo *info
, -const gchar *name
);const gchar *name
);Locate a virtual function slot with name
name
. Note that the namespace for virtuals is distinct from that of methods; there may or may not be a concrete method associated for a virtual. If there is one, it may -be retrieved usingg_vfunc_info_get_invoker()
, otherwiseNULL
will be +be retrieved usingg_vfunc_info_get_invoker()
, otherwiseNULL
will be returned. See the documentation forg_vfunc_info_get_invoker()
for more information on invoking virtuals. @@ -670,13 +800,229 @@- Returns :
the GIVFuncInfo, or NULL
. Free it with +the GIVFuncInfo, or NULL
. Free it withg_base_info_unref()
when done. [transfer full]
+++g_object_info_get_unref_function ()
+const char * g_object_info_get_unref_function (+GIObjectInfo *info
);+Obtain the symbol name of the function that should be called to unref this +object type. It's mainly used fundamental types. The type signature for +the symbol is
+GIObjectInfoUnrefFunction
, to fetch the function pointer +seeg_object_info_get_unref_function()
. +++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the symbol or +NULL
+
+++g_object_info_get_unref_function_pointer ()
+GIObjectInfoUnrefFunction g_object_info_get_unref_function_pointer + (+GIObjectInfo *info
);+Obtain a pointer to a function which can be used to +decrease the reference count an instance of this object type. +This takes derivation into account and will reversely traverse +the base classes of this type, starting at the top type. +
+++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the function pointer or +NULL
+
+++g_object_info_get_ref_function ()
+const char * g_object_info_get_ref_function (+GIObjectInfo *info
);+Obtain the symbol name of the function that should be called to ref this +object type. It's mainly used fundamental types. The type signature for +the symbol is
+GIObjectInfoRefFunction
, to fetch the function pointer +seeg_object_info_get_ref_function()
. +++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the symbol or +NULL
+
+++g_object_info_get_ref_function_pointer ()
+GIObjectInfoRefFunction g_object_info_get_ref_function_pointer + (+GIObjectInfo *info
);+Obtain a pointer to a function which can be used to +increase the reference count an instance of this object type. +This takes derivation into account and will reversely traverse +the base classes of this type, starting at the top type. +
+++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the function pointer or +NULL
+
+++g_object_info_get_set_value_function ()
+const char * g_object_info_get_set_value_function + (+GIObjectInfo *info
);+Obtain the symbol name of the function that should be called to convert +set a GValue giving an object instance pointer of this object type. +I's mainly used fundamental types. The type signature for the symbol +is
+GIObjectInfoSetValueFunction
, to fetch the function pointer +seeg_object_info_get_set_value_function()
. +++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the symbol or +NULL
+
+++g_object_info_get_set_value_function_pointer ()
+GIObjectInfoSetValueFunction g_object_info_get_set_value_function_pointer + (+GIObjectInfo *info
);+Obtain a pointer to a function which can be used to +set a GValue given an instance of this object type. +This takes derivation into account and will reversely traverse +the base classes of this type, starting at the top type. +
+++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the function pointer or +NULL
+
+++g_object_info_get_get_value_function ()
+const char * g_object_info_get_get_value_function + (+GIObjectInfo *info
);+Obtain the symbol name of the function that should be called to convert +an object instance pointer of this object type to a GValue. +I's mainly used fundamental types. The type signature for the symbol +is
+GIObjectInfoGetValueFunction
, to fetch the function pointer +seeg_object_info_get_get_value_function()
. +++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the symbol or +NULL
+
++g_object_info_get_get_value_function_pointer ()
+GIObjectInfoGetValueFunction g_object_info_get_get_value_function_pointer + (+GIObjectInfo *info
);+Obtain a pointer to a function which can be used to +extract an instance of this object type out of a GValue. +This takes derivation into account and will reversely traverse +the base classes of this type, starting at the top type. +
+++
+ + + ++
info
 :a GIObjectInfo + ++ + ++ Returns :
the function pointer or +NULL
+