luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-01-13 07:56:17 +01:00
Code Issues Packages Projects Releases Wiki Activity

added GValue documentation.

Browse Source 
Tue Feb 19 17:45:43 2002  Tim Janik  <timj@gtk.org>

        * gobject/tmpl/generic_values.sgml: added GValue documentation.
This commit is contained in:
Tim Janik 2002-02-19 17:08:11 +00:00 committed by Tim Janik
parent c7e635a922
commit f2620633c1
2 changed files with 26 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/reference/ChangeLog
View File

@ -1,3 +1,7 @@
Tue Feb 19 17:45:43 2002 Tim Janik <timj@gtk.org>
* gobject/tmpl/generic_values.sgml: added GValue documentation.
Thu Feb 7 12:07:06 2002 Tim Janik <timj@gtk.org> Thu Feb 7 12:07:06 2002 Tim Janik <timj@gtk.org>
* gobject/tmpl/generic_values.sgml: document value transformation. * gobject/tmpl/generic_values.sgml: document value transformation.

34
docs/reference/gobject/tmpl/generic_values.sgml
View File

@ -91,23 +91,29 @@ Returns #TRUE if @value is a valid and initialized #GValue structure.
<!-- ##### STRUCT GValue ##### --> <!-- ##### STRUCT GValue ##### -->
<para> <para>
A mostly opaque structure used to hold a #GValue object. Mostly because An opaque structure used to hold different types of values.
the data within the structure has protected scope: it is accessible only The data within the structure has protected scope: it is accessible only
to functions within a #GTypeValueTable structure, or implementations of to functions within a #GTypeValueTable structure, or implementations of
the g_value_*() API. the g_value_*() API. That is, code portions which implement new fundamental
types.
#GValue users can not make any assumptions about how data is stored
within the 2 element #GValue.data[] union, and the g_type member should
only be accessed through the G_VALUE_TYPE() macro.
</para> </para>
<!-- ##### MACRO G_TYPE_VALUE ##### --> <!-- ##### MACRO G_TYPE_VALUE ##### -->
<para> <para>
Returns the type ID of the "GValue" type which is a boxed type,
used to pass around pointers to GValues.
</para> </para>
<!-- ##### MACRO G_TYPE_VALUE_ARRAY ##### --> <!-- ##### MACRO G_TYPE_VALUE_ARRAY ##### -->
<para> <para>
Returns the type ID of the "GValueArray" type which is a boxed type,
used to pass around pointers to GValueArrays.
</para> </para>
@ -175,12 +181,13 @@ This is an internal function introduced mainly for C marshallers.
<!-- ##### FUNCTION g_value_type_compatible ##### --> <!-- ##### FUNCTION g_value_type_compatible ##### -->
<para> <para>
Returns whether a #GValue of type @src_type can be copied into
a #GValue of type @dest_type.
</para> </para>
@src_type: @src_type: source type to be copied.
@dest_type: @dest_type: destination type for copying.
@Returns: @Returns: %TRUE if g_value_copy() is possible with @src_type and @dest_type.
<!-- ##### FUNCTION g_value_type_transformable ##### --> <!-- ##### FUNCTION g_value_type_transformable ##### -->
@ -232,10 +239,13 @@ as rcfile value or object property serialization).
<!-- ##### FUNCTION g_strdup_value_contents ##### --> <!-- ##### FUNCTION g_strdup_value_contents ##### -->
<para> <para>
Return a newly allocated string, which describes the contents of a #GValue.
The main purpose of this function is to describe #GValue contents for debugging
output, the way in which the contents are described may change between different
GLib versions.
</para> </para>
@value: @value: #GValue which contents are to be described.
@Returns: @Returns: Newly allocated string.