</tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td><td>   the length of <em class="parameter"><code>text</code></em>, in bytes</td></tr><tr><td><p><span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></p></td><td>     location to store the list of strings or <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. The           list should be freed with <ahref="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> the number of strings in the resulting              list.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3273844"></a><h3><a name="gdk-text-property-to-utf8-list-for-display"></a>gdk_text_property_to_utf8_list_for_display ()</h3><a class="indexterm" name="id3273862"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a>                gdk_text_property_to_utf8_list_for_display                                                        (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> encoding,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> format,                                                         const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *text,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> length,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> ***list);</pre><p>Converts a text property in the given encoding toa list of UTF-8 strings.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></p></td><td>  a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>encoding</code></em>&#160;:</span></p></td><td> an atom representing the encoding of the text</td></tr><tr><td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td><td>   the format of the property</td></tr><tr><td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td><td>     the text to convert</td></tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td><td>   the length of <em class="parameter"><code>text</code></em>, in bytes</td></tr><tr><td><p><span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></p></td><td>     location to store the list of strings or <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. The           list should be freed with <ahref="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> the number of strings in the resulting              list.</td></tr></tbody></table></div><p class="since">Since  2.2</p></div><hr><div class="refsect2" lang="en"><a name="id3274076"></a><h3><a name="gdk-string-to-compound-text"></a>gdk_string_to_compound_text ()</h3><a class="indexterm" name="id3274090"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a>                gdk_string_to_compound_text         (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);</pre><p>Converts a string from the encoding of the current locale into a form suitable for storing in a window property.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td><td>a nul-terminated string.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>encoding</code></em>&#160;:</span></p></td><td>location to store the encoding atom (to be used as the type for the property).</td></tr><tr><td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td><td>location to store the format for the property.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>ctext</code></em>&#160;:</span></p></td><td>location to store newly allocated data for the property.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td><td>location to store the length of <em class="parameter"><code>ctext</code></em> in items.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td>0 upon sucess, non-zero upon failure.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3274245"></a><h3><a name="gdk-string-to-compound-text-for-display"></a>gdk_string_to_compound_text_for_display ()</h3><a class="indexterm" name="id3274262"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a>                gdk_string_to_compound_text_for_display                                                        (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,                                                         const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str,                                                         <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext,                                                         <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);</pre><p>Convert a string from the encoding of the current locale into a form suitable for storing in a window property.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></p></td><td>  the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where the encoding is defined.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td><td>      a nul-terminated string.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>encoding</code></em>&#160;:</span></p></td><td> location to store the encoding atom       (to be used as the type for the property).</td></tr><tr><td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td><td>   location to store the format of the property</td></tr><tr><td><p><span class="term"><em class="parameter"><code>ctext</code></em>&#160;:</span></p></td><td>    location to store newly allocated data for the property.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td><td>   the length of <em class="parameter"><code>text</code></em>, in bytes</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td><td> 0 upon sucess, non-zero upon failure. </td></tr></tbody></table></div><p class="since">Since  2.2</p></div><hr><div class="refsect2" lang="en"><a name="id3274458"></a><h3><a name="gdk-free-compound-text"></a>gdk_free_compound_text ()</h3><a class="indexterm" name="id3274472"></a><pre class="programlisting">void                gdk_free_compound_text              (<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *ctext);</pre><p>Frees the data returned from <a class="link" href="gdk-Properties-and-Atoms.html#gdk-string-to-compound-text"><code class="function">gdk_string_to_compound_text()</code></a>.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>ctext</code></em>&#160;:</span></p></td><td>The pointer stored in <em class="parameter"><code>ctext</code></em> from a call to <a class="link" href="gdk-Properties-and-Atoms.html#gdk-string-to-compound-text"><code class="function">gdk_string_to_compound_text()</code></a>.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3274548"></a><h3><a name="gdk-utf8-to-string-target"></a>gdk_utf8_to_string_target ()</h3><a class="indexterm" name="id3274561"></a><pre class="programlisting"><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>*              gdk_utf8_to_string_target           (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str);</pre><p>Convert an UTF-8 string into the best possible representationas a STRING. The representation of characters not in STRINGis not specified; it may be as pseudo-escape sequences\x{ABCD}, or it may be in some other form of approximation.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td><td> a UTF-8 string</td>