[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