[telepathy-doc/master] Add a simple type table
Davyd Madeley
davyd at madeley.id.au
Thu Sep 17 05:15:51 PDT 2009
---
docs/book/C/basics.xml | 127 ++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 127 insertions(+), 0 deletions(-)
diff --git a/docs/book/C/basics.xml b/docs/book/C/basics.xml
index f087236..613cde1 100644
--- a/docs/book/C/basics.xml
+++ b/docs/book/C/basics.xml
@@ -989,6 +989,9 @@ get_channels_cb (TpProxy *proxy,
</para>
<para>
+ <classname>GType</classname> types for simple D-Bus types
+ are given in
+ <xref linkend="table.basics.language-bindings.telepathy-glib.types"/>.
Telepathy's complex types are all mapped to generated boxed GTypes
(see
<ulink url="&url_telepathy_glib_base;telepathy-glib-gtypes.html">the
@@ -1004,6 +1007,130 @@ get_channels_cb (TpProxy *proxy,
<function>G_VALUE_TYPE</function>.
</para>
+ <table id="table.basics.language-bindings.telepathy-glib.types">
+ <title>telepathy-glib Types</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>D-Bus Type</entry>
+ <entry>GType</entry>
+ <entry>C type</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>o</literal></entry>
+ <entry><type>DBUS_TYPE_G_OBJECT_PATH</type></entry>
+ <entry>String (<type>char *</type>)</entry>
+ </row>
+ <row>
+ <entry><literal>y</literal></entry>
+ <entry><type>G_TYPE_UCHAR</type></entry>
+ <entry><type>guchar</type></entry>
+ </row>
+ <row>
+ <entry><literal>u</literal></entry>
+ <entry><type>G_TYPE_UINT</type></entry>
+ <entry><type>guint</type></entry>
+ </row>
+ <row>
+ <entry><literal>i</literal></entry>
+ <entry><type>G_TYPE_INT</type></entry>
+ <entry><type>int</type></entry>
+ </row>
+ <row>
+ <entry><literal>t</literal></entry>
+ <entry><type>G_TYPE_UINT64</type></entry>
+ <entry><type>guint64</type></entry>
+ </row>
+ <row>
+ <entry><literal>x</literal></entry>
+ <entry><type>G_TYPE_INT64</type></entry>
+ <entry><type>gint64</type></entry>
+ </row>
+ <row>
+ <entry><literal>d</literal></entry>
+ <entry><type>G_TYPE_DOUBLE</type></entry>
+ <entry><type>double</type></entry>
+ </row>
+ <row>
+ <entry><literal>b</literal></entry>
+ <entry><type>G_TYPE_BOOLEAN</type></entry>
+ <entry><type>gboolean</type></entry>
+ </row>
+ <row>
+ <entry><literal>s</literal></entry>
+ <entry><type>G_TYPE_STRING</type></entry>
+ <entry><type>char *</type></entry>
+ </row>
+
+ <row>
+ <entry><literal>ao</literal></entry>
+ <entry><type>TP_ARRAY_TYPE_OBJECT_PATH_LIST</type></entry>
+ <entry>
+ <classname>GPtrArray</classname> of Strings
+ (<type>char *</type>)
+ </entry>
+ </row>
+ <row>
+ <entry><literal>ay</literal></entry>
+ <entry><type>DBUS_TYPE_G_UCHAR_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>guchar</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>au</literal></entry>
+ <entry><type>DBUS_TYPE_G_UINT_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>guint</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>ai</literal></entry>
+ <entry><type>DBUS_TYPE_G_INT_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>int</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>at</literal></entry>
+ <entry><type>DBUS_TYPE_G_UINT64_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>guint64</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>ax</literal></entry>
+ <entry><type>DBUS_TYPE_G_INT64_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>gint64</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>ad</literal></entry>
+ <entry><type>DBUS_TYPE_G_DOUBLE_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>double</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>ab</literal></entry>
+ <entry><type>DBUS_TYPE_G_BOOLEAN_ARRAY</type></entry>
+ <entry>
+ <classname>GArray</classname> of <type>gboolean</type>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>as</literal></entry>
+ <entry><type>G_TYPE_STRV</type></entry>
+ <entry><type>char **</type></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+
<para>
Decoding the contents of the GValue can be done either from the
<ulink url="&url_telepathy_glib_base;telepathy-glib-gtypes.html">manual</ulink>
--
1.5.6.5
More information about the telepathy-commits
mailing list