docs/reference/glib/html/glib-Key-value-file-parser.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Key-value file parser</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GLib Reference Manual">
   8 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
   9 <link rel="prev" href="glib-Simple-XML-Subset-Parser.html" title="Simple XML Subset Parser">
  10 <link rel="next" href="glib-Bookmark-file-parser.html" title="Bookmark file parser">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="glib-Simple-XML-Subset-Parser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="glib-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GLib Reference Manual</th>
  21 <td><a accesskey="n" href="glib-Bookmark-file-parser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#glib-Key-value-file-parser.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#glib-Key-value-file-parser.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="glib-Key-value-file-parser"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="glib-Key-value-file-parser.top_of_page"></a>Key-value file parser</span></h2>
  34 <p>Key-value file parser — parses .ini-like config files</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="glib-Key-value-file-parser.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;glib.h&gt;
  42
  43                     <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile">GKeyFile</a>;
  44 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR:CAPS" title="G_KEY_FILE_ERROR">G_KEY_FILE_ERROR</a>
  45 enum                <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError">GKeyFileError</a>;
  46 enum                <a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags">GKeyFileFlags</a>;
  47
  48 <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          <a class="link" href="glib-Key-value-file-parser.html#g-key-file-new" title="g_key_file_new ()">g_key_file_new</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
  49 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-free" title="g_key_file_free ()">g_key_file_free</a>                     (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
  50 <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          <a class="link" href="glib-Key-value-file-parser.html#g-key-file-ref" title="g_key_file_ref ()">g_key_file_ref</a>                      (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
  51 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-unref" title="g_key_file_unref ()">g_key_file_unref</a>                    (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
  52 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-list-separator" title="g_key_file_set_list_separator ()">g_key_file_set_list_separator</a>       (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  53                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> separator</code></em>);
  54 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-file" title="g_key_file_load_from_file ()">g_key_file_load_from_file</a>           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  55                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
  56                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
  57                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  58 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-data" title="g_key_file_load_from_data ()">g_key_file_load_from_data</a>           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  59                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *data</code></em>,
  60                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>,
  61                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
  62                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  63 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-data-dirs" title="g_key_file_load_from_data_dirs ()">g_key_file_load_from_data_dirs</a>      (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  64                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
  65                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **full_path</code></em>,
  66                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
  67                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  68 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-dirs" title="g_key_file_load_from_dirs ()">g_key_file_load_from_dirs</a>           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  69                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
  70                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **search_dirs</code></em>,
  71                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **full_path</code></em>,
  72                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
  73                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  74 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-to-data" title="g_key_file_to_data ()">g_key_file_to_data</a>                  (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  75                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
  76                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  77 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-start-group" title="g_key_file_get_start_group ()">g_key_file_get_start_group</a>          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
  78 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-groups" title="g_key_file_get_groups ()">g_key_file_get_groups</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  79                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);
  80 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-keys" title="g_key_file_get_keys ()">g_key_file_get_keys</a>                 (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  81                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
  82                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
  83                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  84 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-has-group" title="g_key_file_has_group ()">g_key_file_has_group</a>                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  85                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>);
  86 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-has-key" title="g_key_file_has_key ()">g_key_file_has_key</a>                  (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  87                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
  88                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
  89                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  90
  91 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-value" title="g_key_file_get_value ()">g_key_file_get_value</a>                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  92                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
  93                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
  94                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  95 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-string" title="g_key_file_get_string ()">g_key_file_get_string</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
  96                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
  97                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
  98                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
  99 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-locale-string" title="g_key_file_get_locale_string ()">g_key_file_get_locale_string</a>        (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 100                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 101                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 102                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
 103                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 104 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-boolean" title="g_key_file_get_boolean ()">g_key_file_get_boolean</a>              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 105                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 106                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 107                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 108 <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-integer" title="g_key_file_get_integer ()">g_key_file_get_integer</a>              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 109                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 110                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 111                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 112 <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-int64" title="g_key_file_get_int64 ()">g_key_file_get_int64</a>                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 113                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 114                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 115                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 116 <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="returnvalue">guint64</span></a>             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-uint64" title="g_key_file_get_uint64 ()">g_key_file_get_uint64</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 117                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 118                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 119                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 120 <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-double" title="g_key_file_get_double ()">g_key_file_get_double</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 121                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 122                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 123                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 124 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-string-list" title="g_key_file_get_string_list ()">g_key_file_get_string_list</a>          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 125                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 126                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 127                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 128                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 129 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-locale-string-list" title="g_key_file_get_locale_string_list ()">g_key_file_get_locale_string_list</a>   (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 130                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 131                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 132                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
 133                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 134                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 135 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> *          <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-boolean-list" title="g_key_file_get_boolean_list ()">g_key_file_get_boolean_list</a>         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 136                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 137                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 138                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 139                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 140 <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> *              <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-integer-list" title="g_key_file_get_integer_list ()">g_key_file_get_integer_list</a>         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 141                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 142                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 143                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 144                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 145 <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> *           <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-double-list" title="g_key_file_get_double_list ()">g_key_file_get_double_list</a>          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 146                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 147                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 148                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 149                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 150 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-comment" title="g_key_file_get_comment ()">g_key_file_get_comment</a>              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 151                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 152                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 153                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 154
 155 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-value" title="g_key_file_set_value ()">g_key_file_set_value</a>                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 156                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 157                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 158                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *value</code></em>);
 159 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-string" title="g_key_file_set_string ()">g_key_file_set_string</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 160                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 161                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 162                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
 163 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-locale-string" title="g_key_file_set_locale_string ()">g_key_file_set_locale_string</a>        (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 164                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 165                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 166                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
 167                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
 168 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-boolean" title="g_key_file_set_boolean ()">g_key_file_set_boolean</a>              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 169                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 170                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 171                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> value</code></em>);
 172 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-integer" title="g_key_file_set_integer ()">g_key_file_set_integer</a>              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 173                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 174                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 175                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> value</code></em>);
 176 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-int64" title="g_key_file_set_int64 ()">g_key_file_set_int64</a>                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 177                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 178                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 179                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> value</code></em>);
 180 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-uint64" title="g_key_file_set_uint64 ()">g_key_file_set_uint64</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 181                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 182                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 183                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> value</code></em>);
 184 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-double" title="g_key_file_set_double ()">g_key_file_set_double</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 185                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 186                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 187                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> value</code></em>);
 188 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-string-list" title="g_key_file_set_string_list ()">g_key_file_set_string_list</a>          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 189                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 190                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 191                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> * const list[]</code></em>,
 192                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);
 193 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-locale-string-list" title="g_key_file_set_locale_string_list ()">g_key_file_set_locale_string_list</a>   (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 194                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 195                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 196                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
 197                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> * const list[]</code></em>,
 198                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);
 199 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-boolean-list" title="g_key_file_set_boolean_list ()">g_key_file_set_boolean_list</a>         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 200                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 201                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 202                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> list[]</code></em>,
 203                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);
 204 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-integer-list" title="g_key_file_set_integer_list ()">g_key_file_set_integer_list</a>         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 205                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 206                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 207                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> list[]</code></em>,
 208                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);
 209 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-double-list" title="g_key_file_set_double_list ()">g_key_file_set_double_list</a>          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 210                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 211                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 212                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> list[]</code></em>,
 213                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);
 214 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-comment" title="g_key_file_set_comment ()">g_key_file_set_comment</a>              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 215                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 216                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 217                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *comment</code></em>,
 218                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 219 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-remove-group" title="g_key_file_remove_group ()">g_key_file_remove_group</a>             (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 220                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 221                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 222 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-remove-key" title="g_key_file_remove_key ()">g_key_file_remove_key</a>               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 223                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 224                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 225                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 226 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-remove-comment" title="g_key_file_remove_comment ()">g_key_file_remove_comment</a>           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 227                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 228                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 229                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);
 230
 231 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP">G_KEY_FILE_DESKTOP_GROUP</a>
 232 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE">G_KEY_FILE_DESKTOP_KEY_TYPE</a>
 233 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-VERSION:CAPS" title="G_KEY_FILE_DESKTOP_KEY_VERSION">G_KEY_FILE_DESKTOP_KEY_VERSION</a>
 234 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-NAME:CAPS" title="G_KEY_FILE_DESKTOP_KEY_NAME">G_KEY_FILE_DESKTOP_KEY_NAME</a>
 235 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-GENERIC-NAME:CAPS" title="G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME">G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME</a>
 236 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-NO-DISPLAY:CAPS" title="G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY">G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY</a>
 237 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-COMMENT:CAPS" title="G_KEY_FILE_DESKTOP_KEY_COMMENT">G_KEY_FILE_DESKTOP_KEY_COMMENT</a>
 238 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-ICON:CAPS" title="G_KEY_FILE_DESKTOP_KEY_ICON">G_KEY_FILE_DESKTOP_KEY_ICON</a>
 239 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-HIDDEN:CAPS" title="G_KEY_FILE_DESKTOP_KEY_HIDDEN">G_KEY_FILE_DESKTOP_KEY_HIDDEN</a>
 240 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-ONLY-SHOW-IN:CAPS" title="G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN">G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN</a>
 241 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-NOT-SHOW-IN:CAPS" title="G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN">G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN</a>
 242 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TRY-EXEC:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TRY_EXEC">G_KEY_FILE_DESKTOP_KEY_TRY_EXEC</a>
 243 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-EXEC:CAPS" title="G_KEY_FILE_DESKTOP_KEY_EXEC">G_KEY_FILE_DESKTOP_KEY_EXEC</a>
 244 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-PATH:CAPS" title="G_KEY_FILE_DESKTOP_KEY_PATH">G_KEY_FILE_DESKTOP_KEY_PATH</a>
 245 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TERMINAL:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TERMINAL">G_KEY_FILE_DESKTOP_KEY_TERMINAL</a>
 246 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-MIME-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_MIME_TYPE">G_KEY_FILE_DESKTOP_KEY_MIME_TYPE</a>
 247 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-CATEGORIES:CAPS" title="G_KEY_FILE_DESKTOP_KEY_CATEGORIES">G_KEY_FILE_DESKTOP_KEY_CATEGORIES</a>
 248 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-STARTUP-NOTIFY:CAPS" title="G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY">G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY</a>
 249 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-STARTUP-WM-CLASS:CAPS" title="G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS">G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS</a>
 250 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-URL:CAPS" title="G_KEY_FILE_DESKTOP_KEY_URL">G_KEY_FILE_DESKTOP_KEY_URL</a>
 251 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-APPLICATION:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_APPLICATION">G_KEY_FILE_DESKTOP_TYPE_APPLICATION</a>
 252 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-LINK:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_LINK">G_KEY_FILE_DESKTOP_TYPE_LINK</a>
 253 #define             <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-DIRECTORY:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_DIRECTORY">G_KEY_FILE_DESKTOP_TYPE_DIRECTORY</a>
 254 </pre>
 255 </div>
 256 <div class="refsect1">
 257 <a name="glib-Key-value-file-parser.description"></a><h2>Description</h2>
 258 <p>
 259 <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> lets you parse, edit or create files containing groups of
 260 key-value pairs, which we call <em class="firstterm">key files</em> for
 261 lack of a better name. Several freedesktop.org specifications use
 262 key files now, e.g the
 263 <a class="ulink" href="http://freedesktop.org/Standards/desktop-entry-spec" target="_top">Desktop
 264 Entry Specification</a> and the
 265 <a class="ulink" href="http://freedesktop.org/Standards/icon-theme-spec" target="_top">Icon
 266 Theme Specification</a>.
 267 </p>
 268 <p>
 269 The syntax of key files is described in detail in the
 270 <a class="ulink" href="http://freedesktop.org/Standards/desktop-entry-spec" target="_top">Desktop
 271 Entry Specification</a>, here is a quick summary: Key files
 272 consists of groups of key-value pairs, interspersed with comments.
 273 </p>
 274 <p>
 275 </p>
 276 <div class="informalexample"><pre class="programlisting">
 277 # this is just an example
 278 # there can be comments before the first group
 279
 280 [First Group]
 281
 282 Name=Key File Example\tthis value shows\nescaping
 283
 284 # localized strings are stored in multiple key-value pairs
 285 Welcome=Hello
 286 Welcome[de]=Hallo
 287 Welcome[fr_FR]=Bonjour
 288 Welcome[it]=Ciao
 289 Welcome[be@latin]=Hello
 290
 291 [Another Group]
 292
 293 Numbers=2;20;-200;0
 294
 295 Booleans=true;false;true;true
 296 </pre></div>
 297 <p>
 298 </p>
 299 <p>
 300 Lines beginning with a '#' and blank lines are considered comments.
 301 </p>
 302 <p>
 303 Groups are started by a header line containing the group name enclosed
 304 in '[' and ']', and ended implicitly by the start of the next group or
 305 the end of the file. Each key-value pair must be contained in a group.
 306 </p>
 307 <p>
 308 Key-value pairs generally have the form <code class="literal">key=value</code>,
 309 with the exception of localized strings, which have the form
 310 <code class="literal">key[locale]=value</code>, with a locale identifier of the
 311 form <code class="literal">lang_COUNTRY<em class="parameter"><code>MODIFIER</code></em></code> where
 312 <code class="literal">COUNTRY</code> and <code class="literal">MODIFIER</code> are optional.
 313 Space before and after the '=' character are ignored. Newline, tab,
 314 carriage return and backslash characters in value are escaped as \n,
 315 \t, \r, and \\, respectively. To preserve leading spaces in values,
 316 these can also be escaped as \s.
 317 </p>
 318 <p>
 319 Key files can store strings (possibly with localized variants), integers,
 320 booleans and lists of these. Lists are separated by a separator character,
 321 typically ';' or ','. To use the list separator character in a value in
 322 a list, it has to be escaped by prefixing it with a backslash.
 323 </p>
 324 <p>
 325 This syntax is obviously inspired by the .ini files commonly met
 326 on Windows, but there are some important differences:
 327 </p>
 328 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
 329 <li class="listitem">.ini files use the ';' character to begin comments,
 330     key files use the '#' character.</li>
 331 <li class="listitem">Key files do not allow for ungrouped keys meaning only
 332     comments can precede the first group.</li>
 333 <li class="listitem">Key files are always encoded in UTF-8.</li>
 334 <li class="listitem">Key and Group names are case-sensitive. For example, a
 335     group called <code class="literal">[GROUP]</code> is a different from
 336     <code class="literal">[group]</code>.</li>
 337 <li class="listitem">.ini files don't have a strongly typed boolean entry type,
 338     they only have <code class="function">GetProfileInt()</code>. In key files, only
 339     <code class="literal">true</code> and <code class="literal">false</code> (in lower case)
 340     are allowed.</li>
 341 </ul></div>
 342 <p>
 343 </p>
 344 <p>
 345 Note that in contrast to the
 346 <a class="ulink" href="http://freedesktop.org/Standards/desktop-entry-spec" target="_top">Desktop
 347 Entry Specification</a>, groups in key files may contain the same
 348 key multiple times; the last entry wins. Key files may also contain
 349 multiple groups with the same name; they are merged together.
 350 Another difference is that keys and group names in key files are not
 351 restricted to ASCII characters.
 352 </p>
 353 </div>
 354 <div class="refsect1">
 355 <a name="glib-Key-value-file-parser.details"></a><h2>Details</h2>
 356 <div class="refsect2">
 357 <a name="GKeyFile"></a><h3>GKeyFile</h3>
 358 <pre class="programlisting">typedef struct _GKeyFile GKeyFile;</pre>
 359 <p>
 360 The GKeyFile struct contains only private data
 361 and should not be accessed directly.
 362 </p>
 363 </div>
 364 <hr>
 365 <div class="refsect2">
 366 <a name="G-KEY-FILE-ERROR:CAPS"></a><h3>G_KEY_FILE_ERROR</h3>
 367 <pre class="programlisting">#define G_KEY_FILE_ERROR g_key_file_error_quark()
 368 </pre>
 369 <p>
 370 Error domain for key file parsing. Errors in this domain will
 371 be from the <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a> enumeration.
 372 </p>
 373 <p>
 374 See <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> for information on error domains.
 375 </p>
 376 </div>
 377 <hr>
 378 <div class="refsect2">
 379 <a name="GKeyFileError"></a><h3>enum GKeyFileError</h3>
 380 <pre class="programlisting">typedef enum {
 381   G_KEY_FILE_ERROR_UNKNOWN_ENCODING,
 382   G_KEY_FILE_ERROR_PARSE,
 383   G_KEY_FILE_ERROR_NOT_FOUND,
 384   G_KEY_FILE_ERROR_KEY_NOT_FOUND,
 385   G_KEY_FILE_ERROR_GROUP_NOT_FOUND,
 386   G_KEY_FILE_ERROR_INVALID_VALUE
 387 } GKeyFileError;
 388 </pre>
 389 <p>
 390 Error codes returned by key file parsing.
 391 </p>
 392 <div class="variablelist"><table border="0">
 393 <col align="left" valign="top">
 394 <tbody>
 395 <tr>
 396 <td><p><a name="G-KEY-FILE-ERROR-UNKNOWN-ENCODING:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_UNKNOWN_ENCODING</code></span></p></td>
 397 <td>the text being parsed was in
 398     an unknown encoding
 399 </td>
 400 </tr>
 401 <tr>
 402 <td><p><a name="G-KEY-FILE-ERROR-PARSE:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_PARSE</code></span></p></td>
 403 <td>document was ill-formed
 404 </td>
 405 </tr>
 406 <tr>
 407 <td><p><a name="G-KEY-FILE-ERROR-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_NOT_FOUND</code></span></p></td>
 408 <td>the file was not found
 409 </td>
 410 </tr>
 411 <tr>
 412 <td><p><a name="G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_KEY_NOT_FOUND</code></span></p></td>
 413 <td>a requested key was not found
 414 </td>
 415 </tr>
 416 <tr>
 417 <td><p><a name="G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</code></span></p></td>
 418 <td>a requested group was not found
 419 </td>
 420 </tr>
 421 <tr>
 422 <td><p><a name="G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_INVALID_VALUE</code></span></p></td>
 423 <td>a value could not be parsed
 424 </td>
 425 </tr>
 426 </tbody>
 427 </table></div>
 428 </div>
 429 <hr>
 430 <div class="refsect2">
 431 <a name="GKeyFileFlags"></a><h3>enum GKeyFileFlags</h3>
 432 <pre class="programlisting">typedef enum {
 433   G_KEY_FILE_NONE              = 0,
 434   G_KEY_FILE_KEEP_COMMENTS     = 1 &lt;&lt; 0,
 435   G_KEY_FILE_KEEP_TRANSLATIONS = 1 &lt;&lt; 1
 436 } GKeyFileFlags;
 437 </pre>
 438 <p>
 439 Flags which influence the parsing.
 440 </p>
 441 <div class="variablelist"><table border="0">
 442 <col align="left" valign="top">
 443 <tbody>
 444 <tr>
 445 <td><p><a name="G-KEY-FILE-NONE:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_NONE</code></span></p></td>
 446 <td>No flags, default behaviour
 447 </td>
 448 </tr>
 449 <tr>
 450 <td><p><a name="G-KEY-FILE-KEEP-COMMENTS:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_KEEP_COMMENTS</code></span></p></td>
 451 <td>Use this flag if you plan to write the
 452     (possibly modified) contents of the key file back to a file;
 453     otherwise all comments will be lost when the key file is
 454     written back.
 455 </td>
 456 </tr>
 457 <tr>
 458 <td><p><a name="G-KEY-FILE-KEEP-TRANSLATIONS:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_KEEP_TRANSLATIONS</code></span></p></td>
 459 <td>Use this flag if you plan to write the
 460     (possibly modified) contents of the key file back to a file;
 461     otherwise only the translations for the current language will be
 462     written back.
 463 </td>
 464 </tr>
 465 </tbody>
 466 </table></div>
 467 </div>
 468 <hr>
 469 <div class="refsect2">
 470 <a name="g-key-file-new"></a><h3>g_key_file_new ()</h3>
 471 <pre class="programlisting"><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          g_key_file_new                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 472 <p>
 473 Creates a new empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> object. Use
 474 <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-file" title="g_key_file_load_from_file ()"><code class="function">g_key_file_load_from_file()</code></a>, <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-data" title="g_key_file_load_from_data ()"><code class="function">g_key_file_load_from_data()</code></a>,
 475 <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-dirs" title="g_key_file_load_from_dirs ()"><code class="function">g_key_file_load_from_dirs()</code></a> or <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-data-dirs" title="g_key_file_load_from_data_dirs ()"><code class="function">g_key_file_load_from_data_dirs()</code></a> to
 476 read an existing key file.
 477 </p>
 478 <div class="variablelist"><table border="0">
 479 <col align="left" valign="top">
 480 <tbody><tr>
 481 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 482 <td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 483 </td>
 484 </tr></tbody>
 485 </table></div>
 486 <p class="since">Since 2.6</p>
 487 </div>
 488 <hr>
 489 <div class="refsect2">
 490 <a name="g-key-file-free"></a><h3>g_key_file_free ()</h3>
 491 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_free                     (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
 492 <p>
 493 Clears all keys and groups from <em class="parameter"><code>key_file</code></em>, and decreases the
 494 reference count by 1. If the reference count reaches zero,
 495 frees the key file and all its allocated memory.
 496 </p>
 497 <div class="variablelist"><table border="0">
 498 <col align="left" valign="top">
 499 <tbody><tr>
 500 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 501 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 502 </td>
 503 </tr></tbody>
 504 </table></div>
 505 <p class="since">Since 2.6</p>
 506 </div>
 507 <hr>
 508 <div class="refsect2">
 509 <a name="g-key-file-ref"></a><h3>g_key_file_ref ()</h3>
 510 <pre class="programlisting"><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          g_key_file_ref                      (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
 511 <p>
 512 Increases the reference count of <em class="parameter"><code>key_file</code></em>.
 513 </p>
 514 <div class="variablelist"><table border="0">
 515 <col align="left" valign="top">
 516 <tbody>
 517 <tr>
 518 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 519 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 520 </td>
 521 </tr>
 522 <tr>
 523 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 524 <td>the same <em class="parameter"><code>key_file</code></em>.</td>
 525 </tr>
 526 </tbody>
 527 </table></div>
 528 <p class="since">Since 2.32</p>
 529 </div>
 530 <hr>
 531 <div class="refsect2">
 532 <a name="g-key-file-unref"></a><h3>g_key_file_unref ()</h3>
 533 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_unref                    (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
 534 <p>
 535 Decreases the reference count of <em class="parameter"><code>key_file</code></em> by 1. If the reference count
 536 reaches zero, frees the key file and all its allocated memory.
 537 </p>
 538 <div class="variablelist"><table border="0">
 539 <col align="left" valign="top">
 540 <tbody><tr>
 541 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 542 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 543 </td>
 544 </tr></tbody>
 545 </table></div>
 546 <p class="since">Since 2.32</p>
 547 </div>
 548 <hr>
 549 <div class="refsect2">
 550 <a name="g-key-file-set-list-separator"></a><h3>g_key_file_set_list_separator ()</h3>
 551 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_list_separator       (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 552                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> separator</code></em>);</pre>
 553 <p>
 554 Sets the character which is used to separate
 555 values in lists. Typically ';' or ',' are used
 556 as separators. The default list separator is ';'.
 557 </p>
 558 <div class="variablelist"><table border="0">
 559 <col align="left" valign="top">
 560 <tbody>
 561 <tr>
 562 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 563 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 564 </td>
 565 </tr>
 566 <tr>
 567 <td><p><span class="term"><em class="parameter"><code>separator</code></em> :</span></p></td>
 568 <td>the separator</td>
 569 </tr>
 570 </tbody>
 571 </table></div>
 572 <p class="since">Since 2.6</p>
 573 </div>
 574 <hr>
 575 <div class="refsect2">
 576 <a name="g-key-file-load-from-file"></a><h3>g_key_file_load_from_file ()</h3>
 577 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_load_from_file           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 578                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
 579                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
 580                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 581 <p>
 582 Loads a key file into an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> structure.
 583 If the file could not be loaded then <em class="parameter"><code>error</code></em> is set to
 584 either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> or <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 585 </p>
 586 <div class="variablelist"><table border="0">
 587 <col align="left" valign="top">
 588 <tbody>
 589 <tr>
 590 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 591 <td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> struct</td>
 592 </tr>
 593 <tr>
 594 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
 595 <td>the path of a filename to load, in the GLib filename encoding. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
 596 </td>
 597 </tr>
 598 <tr>
 599 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 600 <td>flags from <a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a>
 601 </td>
 602 </tr>
 603 <tr>
 604 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 605 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 606 </td>
 607 </tr>
 608 <tr>
 609 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 610 <td>
 611 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a key file could be loaded, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
 612 </tr>
 613 </tbody>
 614 </table></div>
 615 <p class="since">Since 2.6</p>
 616 </div>
 617 <hr>
 618 <div class="refsect2">
 619 <a name="g-key-file-load-from-data"></a><h3>g_key_file_load_from_data ()</h3>
 620 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_load_from_data           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 621                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *data</code></em>,
 622                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>,
 623                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
 624                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 625 <p>
 626 Loads a key file from memory into an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> structure.
 627 If the object cannot be created then <code class="literal">error</code> is set to a <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 628 </p>
 629 <div class="variablelist"><table border="0">
 630 <col align="left" valign="top">
 631 <tbody>
 632 <tr>
 633 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 634 <td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> struct</td>
 635 </tr>
 636 <tr>
 637 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 638 <td>key file loaded in memory</td>
 639 </tr>
 640 <tr>
 641 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 642 <td>the length of <em class="parameter"><code>data</code></em> in bytes (or -1 if data is nul-terminated)</td>
 643 </tr>
 644 <tr>
 645 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 646 <td>flags from <a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a>
 647 </td>
 648 </tr>
 649 <tr>
 650 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 651 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 652 </td>
 653 </tr>
 654 <tr>
 655 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 656 <td>
 657 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a key file could be loaded, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
 658 </tr>
 659 </tbody>
 660 </table></div>
 661 <p class="since">Since 2.6</p>
 662 </div>
 663 <hr>
 664 <div class="refsect2">
 665 <a name="g-key-file-load-from-data-dirs"></a><h3>g_key_file_load_from_data_dirs ()</h3>
 666 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_load_from_data_dirs      (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 667                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
 668                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **full_path</code></em>,
 669                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
 670                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 671 <p>
 672 This function looks for a key file named <em class="parameter"><code>file</code></em> in the paths
 673 returned from <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-data-dir" title="g_get_user_data_dir ()"><code class="function">g_get_user_data_dir()</code></a> and <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-system-data-dirs" title="g_get_system_data_dirs ()"><code class="function">g_get_system_data_dirs()</code></a>,
 674 loads the file into <em class="parameter"><code>key_file</code></em> and returns the file's full path in
 675 <em class="parameter"><code>full_path</code></em>.  If the file could not be loaded then an <code class="literal">error</code> is
 676 set to either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> or <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 677 </p>
 678 <div class="variablelist"><table border="0">
 679 <col align="left" valign="top">
 680 <tbody>
 681 <tr>
 682 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 683 <td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> struct</td>
 684 </tr>
 685 <tr>
 686 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
 687 <td>a relative path to a filename to open and parse. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
 688 </td>
 689 </tr>
 690 <tr>
 691 <td><p><span class="term"><em class="parameter"><code>full_path</code></em> :</span></p></td>
 692 <td>return location for a string containing the full path
 693 of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 694 </td>
 695 </tr>
 696 <tr>
 697 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 698 <td>flags from <a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a>
 699 </td>
 700 </tr>
 701 <tr>
 702 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 703 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 704 </td>
 705 </tr>
 706 <tr>
 707 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 708 <td>
 709 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a key file could be loaded, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> othewise</td>
 710 </tr>
 711 </tbody>
 712 </table></div>
 713 <p class="since">Since 2.6</p>
 714 </div>
 715 <hr>
 716 <div class="refsect2">
 717 <a name="g-key-file-load-from-dirs"></a><h3>g_key_file_load_from_dirs ()</h3>
 718 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_load_from_dirs           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 719                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
 720                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **search_dirs</code></em>,
 721                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **full_path</code></em>,
 722                                                          <em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a> flags</code></em>,
 723                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 724 <p>
 725 This function looks for a key file named <em class="parameter"><code>file</code></em> in the paths
 726 specified in <em class="parameter"><code>search_dirs</code></em>, loads the file into <em class="parameter"><code>key_file</code></em> and
 727 returns the file's full path in <em class="parameter"><code>full_path</code></em>.  If the file could not
 728 be loaded then an <code class="literal">error</code> is set to either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> or
 729 <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 730 </p>
 731 <div class="variablelist"><table border="0">
 732 <col align="left" valign="top">
 733 <tbody>
 734 <tr>
 735 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 736 <td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> struct</td>
 737 </tr>
 738 <tr>
 739 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
 740 <td>a relative path to a filename to open and parse. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
 741 </td>
 742 </tr>
 743 <tr>
 744 <td><p><span class="term"><em class="parameter"><code>search_dirs</code></em> :</span></p></td>
 745 <td>
 746 <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of directories to search. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename]</span>
 747 </td>
 748 </tr>
 749 <tr>
 750 <td><p><span class="term"><em class="parameter"><code>full_path</code></em> :</span></p></td>
 751 <td>return location for a string containing the full path
 752 of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 753 </td>
 754 </tr>
 755 <tr>
 756 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 757 <td>flags from <a class="link" href="glib-Key-value-file-parser.html#GKeyFileFlags" title="enum GKeyFileFlags"><span class="type">GKeyFileFlags</span></a>
 758 </td>
 759 </tr>
 760 <tr>
 761 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 762 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 763 </td>
 764 </tr>
 765 <tr>
 766 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 767 <td>
 768 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a key file could be loaded, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
 769 </tr>
 770 </tbody>
 771 </table></div>
 772 <p class="since">Since 2.14</p>
 773 </div>
 774 <hr>
 775 <div class="refsect2">
 776 <a name="g-key-file-to-data"></a><h3>g_key_file_to_data ()</h3>
 777 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_key_file_to_data                  (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 778                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 779                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 780 <p>
 781 This function outputs <em class="parameter"><code>key_file</code></em> as a string.
 782 </p>
 783 <p>
 784 Note that this function never reports an error,
 785 so it is safe to pass <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> as <em class="parameter"><code>error</code></em>.
 786 </p>
 787 <div class="variablelist"><table border="0">
 788 <col align="left" valign="top">
 789 <tbody>
 790 <tr>
 791 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 792 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 793 </td>
 794 </tr>
 795 <tr>
 796 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 797 <td>return location for the length of the
 798 returned string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 799 </td>
 800 </tr>
 801 <tr>
 802 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 803 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 804 </td>
 805 </tr>
 806 <tr>
 807 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 808 <td>a newly allocated string holding
 809 the contents of the <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 810 </td>
 811 </tr>
 812 </tbody>
 813 </table></div>
 814 <p class="since">Since 2.6</p>
 815 </div>
 816 <hr>
 817 <div class="refsect2">
 818 <a name="g-key-file-get-start-group"></a><h3>g_key_file_get_start_group ()</h3>
 819 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_key_file_get_start_group          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
 820 <p>
 821 Returns the name of the start group of the file.
 822 </p>
 823 <div class="variablelist"><table border="0">
 824 <col align="left" valign="top">
 825 <tbody>
 826 <tr>
 827 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 828 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 829 </td>
 830 </tr>
 831 <tr>
 832 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 833 <td>The start group of the key file.</td>
 834 </tr>
 835 </tbody>
 836 </table></div>
 837 <p class="since">Since 2.6</p>
 838 </div>
 839 <hr>
 840 <div class="refsect2">
 841 <a name="g-key-file-get-groups"></a><h3>g_key_file_get_groups ()</h3>
 842 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_key_file_get_groups               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 843                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
 844 <p>
 845 Returns all groups in the key file loaded with <em class="parameter"><code>key_file</code></em>.
 846 The array of returned groups will be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated, so
 847 <em class="parameter"><code>length</code></em> may optionally be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
 848 </p>
 849 <div class="variablelist"><table border="0">
 850 <col align="left" valign="top">
 851 <tbody>
 852 <tr>
 853 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 854 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 855 </td>
 856 </tr>
 857 <tr>
 858 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 859 <td>return location for the number of returned groups, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 860 </td>
 861 </tr>
 862 <tr>
 863 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 864 <td>a newly-allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
 865 Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 866 </td>
 867 </tr>
 868 </tbody>
 869 </table></div>
 870 <p class="since">Since 2.6</p>
 871 </div>
 872 <hr>
 873 <div class="refsect2">
 874 <a name="g-key-file-get-keys"></a><h3>g_key_file_get_keys ()</h3>
 875 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_key_file_get_keys                 (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 876                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 877                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 878                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 879 <p>
 880 Returns all keys for the group name <em class="parameter"><code>group_name</code></em>.  The array of
 881 returned keys will be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated, so <em class="parameter"><code>length</code></em> may
 882 optionally be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. In the event that the <em class="parameter"><code>group_name</code></em> cannot
 883 be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set to
 884 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
 885 </p>
 886 <div class="variablelist"><table border="0">
 887 <col align="left" valign="top">
 888 <tbody>
 889 <tr>
 890 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 891 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 892 </td>
 893 </tr>
 894 <tr>
 895 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
 896 <td>a group name</td>
 897 </tr>
 898 <tr>
 899 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 900 <td>return location for the number of keys returned, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 901 </td>
 902 </tr>
 903 <tr>
 904 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 905 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 906 </td>
 907 </tr>
 908 <tr>
 909 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 910 <td>a newly-allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
 911 Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 912 </td>
 913 </tr>
 914 </tbody>
 915 </table></div>
 916 <p class="since">Since 2.6</p>
 917 </div>
 918 <hr>
 919 <div class="refsect2">
 920 <a name="g-key-file-has-group"></a><h3>g_key_file_has_group ()</h3>
 921 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_has_group                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 922                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>);</pre>
 923 <p>
 924 Looks whether the key file has the group <em class="parameter"><code>group_name</code></em>.
 925 </p>
 926 <div class="variablelist"><table border="0">
 927 <col align="left" valign="top">
 928 <tbody>
 929 <tr>
 930 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 931 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 932 </td>
 933 </tr>
 934 <tr>
 935 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
 936 <td>a group name</td>
 937 </tr>
 938 <tr>
 939 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 940 <td>
 941 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>group_name</code></em> is a part of <em class="parameter"><code>key_file</code></em>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
 942 otherwise.</td>
 943 </tr>
 944 </tbody>
 945 </table></div>
 946 <p class="since">Since 2.6</p>
 947 </div>
 948 <hr>
 949 <div class="refsect2">
 950 <a name="g-key-file-has-key"></a><h3>g_key_file_has_key ()</h3>
 951 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_has_key                  (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
 952                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
 953                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
 954                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 955 <p>
 956 Looks whether the key file has the key <em class="parameter"><code>key</code></em> in the group
 957 <em class="parameter"><code>group_name</code></em>.
 958 </p>
 959 <p>
 960 </p>
 961 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 962 <h3 class="title">Note</h3>This function does not follow the rules for <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> strictly;
 963 the return value both carries meaning and signals an error.  To use
 964 this function, you must pass a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> pointer in <em class="parameter"><code>error</code></em>, and check
 965 whether it is not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to see if an error occurred.</div>
 966 <p>
 967 </p>
 968 <p>
 969 Language bindings should use <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-value" title="g_key_file_get_value ()"><code class="function">g_key_file_get_value()</code></a> to test whether
 970 or not a key exists.
 971 </p>
 972 <div class="variablelist"><table border="0">
 973 <col align="left" valign="top">
 974 <tbody>
 975 <tr>
 976 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 977 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
 978 </td>
 979 </tr>
 980 <tr>
 981 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
 982 <td>a group name</td>
 983 </tr>
 984 <tr>
 985 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
 986 <td>a key name</td>
 987 </tr>
 988 <tr>
 989 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 990 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
 991 </td>
 992 </tr>
 993 <tr>
 994 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 995 <td>
 996 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>key</code></em> is a part of <em class="parameter"><code>group_name</code></em>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
 997 otherwise.</td>
 998 </tr>
 999 </tbody>
1000 </table></div>
1001 <p class="since">Since 2.6</p>
1002 </div>
1003 <hr>
1004 <div class="refsect2">
1005 <a name="g-key-file-get-value"></a><h3>g_key_file_get_value ()</h3>
1006 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_key_file_get_value                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1007                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1008                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1009                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1010 <p>
1011 Returns the raw value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1012 Use <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-string" title="g_key_file_get_string ()"><code class="function">g_key_file_get_string()</code></a> to retrieve an unescaped UTF-8 string.
1013 </p>
1014 <p>
1015 In the event the key cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
1016 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>.  In the
1017 event that the <em class="parameter"><code>group_name</code></em> cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
1018 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
1019 </p>
1020 <div class="variablelist"><table border="0">
1021 <col align="left" valign="top">
1022 <tbody>
1023 <tr>
1024 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1025 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1026 </td>
1027 </tr>
1028 <tr>
1029 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1030 <td>a group name</td>
1031 </tr>
1032 <tr>
1033 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1034 <td>a key</td>
1035 </tr>
1036 <tr>
1037 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1038 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1039 </td>
1040 </tr>
1041 <tr>
1042 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1043 <td>a newly allocated string or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the specified
1044 key cannot be found.</td>
1045 </tr>
1046 </tbody>
1047 </table></div>
1048 <p class="since">Since 2.6</p>
1049 </div>
1050 <hr>
1051 <div class="refsect2">
1052 <a name="g-key-file-get-string"></a><h3>g_key_file_get_string ()</h3>
1053 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_key_file_get_string               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1054                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1055                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1056                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1057 <p>
1058 Returns the string value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1059 Unlike <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-value" title="g_key_file_get_value ()"><code class="function">g_key_file_get_value()</code></a>, this function handles escape sequences
1060 like \s.
1061 </p>
1062 <p>
1063 In the event the key cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
1064 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>.  In the
1065 event that the <em class="parameter"><code>group_name</code></em> cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
1066 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
1067 </p>
1068 <div class="variablelist"><table border="0">
1069 <col align="left" valign="top">
1070 <tbody>
1071 <tr>
1072 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1073 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1074 </td>
1075 </tr>
1076 <tr>
1077 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1078 <td>a group name</td>
1079 </tr>
1080 <tr>
1081 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1082 <td>a key</td>
1083 </tr>
1084 <tr>
1085 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1086 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1087 </td>
1088 </tr>
1089 <tr>
1090 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1091 <td>a newly allocated string or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the specified
1092 key cannot be found.</td>
1093 </tr>
1094 </tbody>
1095 </table></div>
1096 <p class="since">Since 2.6</p>
1097 </div>
1098 <hr>
1099 <div class="refsect2">
1100 <a name="g-key-file-get-locale-string"></a><h3>g_key_file_get_locale_string ()</h3>
1101 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_key_file_get_locale_string        (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1102                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1103                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1104                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
1105                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1106 <p>
1107 Returns the value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>
1108 translated in the given <em class="parameter"><code>locale</code></em> if available.  If <em class="parameter"><code>locale</code></em> is
1109 <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then the current locale is assumed.
1110 </p>
1111 <p>
1112 If <em class="parameter"><code>key</code></em> cannot be found then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set
1113 to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. If the value associated
1114 with <em class="parameter"><code>key</code></em> cannot be interpreted or no suitable translation can
1115 be found then the untranslated value is returned.
1116 </p>
1117 <div class="variablelist"><table border="0">
1118 <col align="left" valign="top">
1119 <tbody>
1120 <tr>
1121 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1122 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1123 </td>
1124 </tr>
1125 <tr>
1126 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1127 <td>a group name</td>
1128 </tr>
1129 <tr>
1130 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1131 <td>a key</td>
1132 </tr>
1133 <tr>
1134 <td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
1135 <td>a locale identifier or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1136 </td>
1137 </tr>
1138 <tr>
1139 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1140 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1141 </td>
1142 </tr>
1143 <tr>
1144 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1145 <td>a newly allocated string or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the specified
1146 key cannot be found.</td>
1147 </tr>
1148 </tbody>
1149 </table></div>
1150 <p class="since">Since 2.6</p>
1151 </div>
1152 <hr>
1153 <div class="refsect2">
1154 <a name="g-key-file-get-boolean"></a><h3>g_key_file_get_boolean ()</h3>
1155 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_get_boolean              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1156                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1157                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1158                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1159 <p>
1160 Returns the value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as a
1161 boolean.
1162 </p>
1163 <p>
1164 If <em class="parameter"><code>key</code></em> cannot be found then <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>error</code></em> is set
1165 to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. Likewise, if the value
1166 associated with <em class="parameter"><code>key</code></em> cannot be interpreted as a boolean then <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
1167 is returned and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
1168 </p>
1169 <div class="variablelist"><table border="0">
1170 <col align="left" valign="top">
1171 <tbody>
1172 <tr>
1173 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1174 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1175 </td>
1176 </tr>
1177 <tr>
1178 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1179 <td>a group name</td>
1180 </tr>
1181 <tr>
1182 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1183 <td>a key</td>
1184 </tr>
1185 <tr>
1186 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1187 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1188 </td>
1189 </tr>
1190 <tr>
1191 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1192 <td>the value associated with the key as a boolean,
1193 or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if the key was not found or could not be parsed.</td>
1194 </tr>
1195 </tbody>
1196 </table></div>
1197 <p class="since">Since 2.6</p>
1198 </div>
1199 <hr>
1200 <div class="refsect2">
1201 <a name="g-key-file-get-integer"></a><h3>g_key_file_get_integer ()</h3>
1202 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_key_file_get_integer              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1203                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1204                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1205                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1206 <p>
1207 Returns the value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as an
1208 integer.
1209 </p>
1210 <p>
1211 If <em class="parameter"><code>key</code></em> cannot be found then 0 is returned and <em class="parameter"><code>error</code></em> is set to
1212 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. Likewise, if the value associated
1213 with <em class="parameter"><code>key</code></em> cannot be interpreted as an integer then 0 is returned
1214 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
1215 </p>
1216 <div class="variablelist"><table border="0">
1217 <col align="left" valign="top">
1218 <tbody>
1219 <tr>
1220 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1221 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1222 </td>
1223 </tr>
1224 <tr>
1225 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1226 <td>a group name</td>
1227 </tr>
1228 <tr>
1229 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1230 <td>a key</td>
1231 </tr>
1232 <tr>
1233 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1234 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1235 </td>
1236 </tr>
1237 <tr>
1238 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1239 <td>the value associated with the key as an integer, or
1240 0 if the key was not found or could not be parsed.</td>
1241 </tr>
1242 </tbody>
1243 </table></div>
1244 <p class="since">Since 2.6</p>
1245 </div>
1246 <hr>
1247 <div class="refsect2">
1248 <a name="g-key-file-get-int64"></a><h3>g_key_file_get_int64 ()</h3>
1249 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="returnvalue">gint64</span></a>              g_key_file_get_int64                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1250                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1251                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1252                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1253 <p>
1254 Returns the value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as a signed
1255 64-bit integer. This is similar to <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-integer" title="g_key_file_get_integer ()"><code class="function">g_key_file_get_integer()</code></a> but can return
1256 64-bit results without truncation.
1257 </p>
1258 <div class="variablelist"><table border="0">
1259 <col align="left" valign="top">
1260 <tbody>
1261 <tr>
1262 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1263 <td>a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1264 </td>
1265 </tr>
1266 <tr>
1267 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1268 <td>a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> group name</td>
1269 </tr>
1270 <tr>
1271 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1272 <td>a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> key</td>
1273 </tr>
1274 <tr>
1275 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1276 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1277 </td>
1278 </tr>
1279 <tr>
1280 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1281 <td>the value associated with the key as a signed 64-bit integer, or
1282 0 if the key was not found or could not be parsed.</td>
1283 </tr>
1284 </tbody>
1285 </table></div>
1286 <p class="since">Since 2.26</p>
1287 </div>
1288 <hr>
1289 <div class="refsect2">
1290 <a name="g-key-file-get-uint64"></a><h3>g_key_file_get_uint64 ()</h3>
1291 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="returnvalue">guint64</span></a>             g_key_file_get_uint64               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1292                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1293                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1294                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1295 <p>
1296 Returns the value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as an unsigned
1297 64-bit integer. This is similar to <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-integer" title="g_key_file_get_integer ()"><code class="function">g_key_file_get_integer()</code></a> but can return
1298 large positive results without truncation.
1299 </p>
1300 <div class="variablelist"><table border="0">
1301 <col align="left" valign="top">
1302 <tbody>
1303 <tr>
1304 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1305 <td>a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1306 </td>
1307 </tr>
1308 <tr>
1309 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1310 <td>a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> group name</td>
1311 </tr>
1312 <tr>
1313 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1314 <td>a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> key</td>
1315 </tr>
1316 <tr>
1317 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1318 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1319 </td>
1320 </tr>
1321 <tr>
1322 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1323 <td>the value associated with the key as an unsigned 64-bit integer,
1324 or 0 if the key was not found or could not be parsed.</td>
1325 </tr>
1326 </tbody>
1327 </table></div>
1328 <p class="since">Since 2.26</p>
1329 </div>
1330 <hr>
1331 <div class="refsect2">
1332 <a name="g-key-file-get-double"></a><h3>g_key_file_get_double ()</h3>
1333 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a>             g_key_file_get_double               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1334                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1335                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1336                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1337 <p>
1338 Returns the value associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as a
1339 double. If <em class="parameter"><code>group_name</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the start_group is used.
1340 </p>
1341 <p>
1342 If <em class="parameter"><code>key</code></em> cannot be found then 0.0 is returned and <em class="parameter"><code>error</code></em> is set to
1343 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. Likewise, if the value associated
1344 with <em class="parameter"><code>key</code></em> cannot be interpreted as a double then 0.0 is returned
1345 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
1346 </p>
1347 <div class="variablelist"><table border="0">
1348 <col align="left" valign="top">
1349 <tbody>
1350 <tr>
1351 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1352 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1353 </td>
1354 </tr>
1355 <tr>
1356 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1357 <td>a group name</td>
1358 </tr>
1359 <tr>
1360 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1361 <td>a key</td>
1362 </tr>
1363 <tr>
1364 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1365 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1366 </td>
1367 </tr>
1368 <tr>
1369 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1370 <td>the value associated with the key as a double, or
1371 0.0 if the key was not found or could not be parsed.</td>
1372 </tr>
1373 </tbody>
1374 </table></div>
1375 <p class="since">Since 2.12</p>
1376 </div>
1377 <hr>
1378 <div class="refsect2">
1379 <a name="g-key-file-get-string-list"></a><h3>g_key_file_get_string_list ()</h3>
1380 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_key_file_get_string_list          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1381                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1382                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1383                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1384                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1385 <p>
1386 Returns the values associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1387 </p>
1388 <p>
1389 In the event the key cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
1390 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>.  In the
1391 event that the <em class="parameter"><code>group_name</code></em> cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
1392 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
1393 </p>
1394 <div class="variablelist"><table border="0">
1395 <col align="left" valign="top">
1396 <tbody>
1397 <tr>
1398 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1399 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1400 </td>
1401 </tr>
1402 <tr>
1403 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1404 <td>a group name</td>
1405 </tr>
1406 <tr>
1407 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1408 <td>a key</td>
1409 </tr>
1410 <tr>
1411 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1412 <td>return location for the number of returned strings, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1413 </td>
1414 </tr>
1415 <tr>
1416 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1417 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1418 </td>
1419 </tr>
1420 <tr>
1421 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1422 <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated string array or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the specified
1423 key cannot be found. The array should be freed with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1424 </td>
1425 </tr>
1426 </tbody>
1427 </table></div>
1428 <p class="since">Since 2.6</p>
1429 </div>
1430 <hr>
1431 <div class="refsect2">
1432 <a name="g-key-file-get-locale-string-list"></a><h3>g_key_file_get_locale_string_list ()</h3>
1433 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_key_file_get_locale_string_list   (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1434                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1435                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1436                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
1437                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1438                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1439 <p>
1440 Returns the values associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>
1441 translated in the given <em class="parameter"><code>locale</code></em> if available.  If <em class="parameter"><code>locale</code></em> is
1442 <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then the current locale is assumed.
1443 </p>
1444 <p>
1445 If <em class="parameter"><code>key</code></em> cannot be found then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set
1446 to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. If the values associated
1447 with <em class="parameter"><code>key</code></em> cannot be interpreted or no suitable translations
1448 can be found then the untranslated values are returned. The
1449 returned array is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated, so <em class="parameter"><code>length</code></em> may optionally
1450 be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
1451 </p>
1452 <div class="variablelist"><table border="0">
1453 <col align="left" valign="top">
1454 <tbody>
1455 <tr>
1456 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1457 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1458 </td>
1459 </tr>
1460 <tr>
1461 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1462 <td>a group name</td>
1463 </tr>
1464 <tr>
1465 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1466 <td>a key</td>
1467 </tr>
1468 <tr>
1469 <td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
1470 <td>a locale identifier or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1471 </td>
1472 </tr>
1473 <tr>
1474 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1475 <td>return location for the number of returned strings or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1476 </td>
1477 </tr>
1478 <tr>
1479 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1480 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1481 </td>
1482 </tr>
1483 <tr>
1484 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1485 <td>a newly allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated string array
1486 or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the key isn't found. The string array should be freed
1487 with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1488 </td>
1489 </tr>
1490 </tbody>
1491 </table></div>
1492 <p class="since">Since 2.6</p>
1493 </div>
1494 <hr>
1495 <div class="refsect2">
1496 <a name="g-key-file-get-boolean-list"></a><h3>g_key_file_get_boolean_list ()</h3>
1497 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> *          g_key_file_get_boolean_list         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1498                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1499                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1500                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1501                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1502 <p>
1503 Returns the values associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as
1504 booleans.
1505 </p>
1506 <p>
1507 If <em class="parameter"><code>key</code></em> cannot be found then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set to
1508 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. Likewise, if the values associated
1509 with <em class="parameter"><code>key</code></em> cannot be interpreted as booleans then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
1510 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
1511 </p>
1512 <div class="variablelist"><table border="0">
1513 <col align="left" valign="top">
1514 <tbody>
1515 <tr>
1516 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1517 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1518 </td>
1519 </tr>
1520 <tr>
1521 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1522 <td>a group name</td>
1523 </tr>
1524 <tr>
1525 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1526 <td>a key</td>
1527 </tr>
1528 <tr>
1529 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1530 <td>the number of booleans returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1531 </td>
1532 </tr>
1533 <tr>
1534 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1535 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1536 </td>
1537 </tr>
1538 <tr>
1539 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1540 <td>the values associated with the key as a list of booleans, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the
1541 key was not found or could not be parsed. The returned list of booleans
1542 should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gboolean][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
1543 </td>
1544 </tr>
1545 </tbody>
1546 </table></div>
1547 <p class="since">Since 2.6</p>
1548 </div>
1549 <hr>
1550 <div class="refsect2">
1551 <a name="g-key-file-get-integer-list"></a><h3>g_key_file_get_integer_list ()</h3>
1552 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> *              g_key_file_get_integer_list         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1553                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1554                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1555                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1556                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1557 <p>
1558 Returns the values associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as
1559 integers.
1560 </p>
1561 <p>
1562 If <em class="parameter"><code>key</code></em> cannot be found then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set to
1563 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. Likewise, if the values associated
1564 with <em class="parameter"><code>key</code></em> cannot be interpreted as integers then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
1565 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
1566 </p>
1567 <div class="variablelist"><table border="0">
1568 <col align="left" valign="top">
1569 <tbody>
1570 <tr>
1571 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1572 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1573 </td>
1574 </tr>
1575 <tr>
1576 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1577 <td>a group name</td>
1578 </tr>
1579 <tr>
1580 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1581 <td>a key</td>
1582 </tr>
1583 <tr>
1584 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1585 <td>the number of integers returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1586 </td>
1587 </tr>
1588 <tr>
1589 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1590 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1591 </td>
1592 </tr>
1593 <tr>
1594 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1595 <td>the values associated with the key as a list of integers, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if
1596 the key was not found or could not be parsed. The returned list of
1597 integers should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gint][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
1598 </td>
1599 </tr>
1600 </tbody>
1601 </table></div>
1602 <p class="since">Since 2.6</p>
1603 </div>
1604 <hr>
1605 <div class="refsect2">
1606 <a name="g-key-file-get-double-list"></a><h3>g_key_file_get_double_list ()</h3>
1607 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> *           g_key_file_get_double_list          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1608                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1609                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1610                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1611                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1612 <p>
1613 Returns the values associated with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em> as
1614 doubles.
1615 </p>
1616 <p>
1617 If <em class="parameter"><code>key</code></em> cannot be found then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set to
1618 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_KEY_NOT_FOUND</span></a>. Likewise, if the values associated
1619 with <em class="parameter"><code>key</code></em> cannot be interpreted as doubles then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
1620 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
1621 </p>
1622 <div class="variablelist"><table border="0">
1623 <col align="left" valign="top">
1624 <tbody>
1625 <tr>
1626 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1627 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1628 </td>
1629 </tr>
1630 <tr>
1631 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1632 <td>a group name</td>
1633 </tr>
1634 <tr>
1635 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1636 <td>a key</td>
1637 </tr>
1638 <tr>
1639 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1640 <td>the number of doubles returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1641 </td>
1642 </tr>
1643 <tr>
1644 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1645 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1646 </td>
1647 </tr>
1648 <tr>
1649 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1650 <td>the values associated with the key as a list of doubles, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the
1651 key was not found or could not be parsed. The returned list of doubles
1652 should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gdouble][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
1653 </td>
1654 </tr>
1655 </tbody>
1656 </table></div>
1657 <p class="since">Since 2.12</p>
1658 </div>
1659 <hr>
1660 <div class="refsect2">
1661 <a name="g-key-file-get-comment"></a><h3>g_key_file_get_comment ()</h3>
1662 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_key_file_get_comment              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1663                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1664                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1665                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1666 <p>
1667 Retrieves a comment above <em class="parameter"><code>key</code></em> from <em class="parameter"><code>group_name</code></em>.
1668 If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then <em class="parameter"><code>comment</code></em> will be read from above
1669 <em class="parameter"><code>group_name</code></em>. If both <em class="parameter"><code>key</code></em> and <em class="parameter"><code>group_name</code></em> are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then
1670 <em class="parameter"><code>comment</code></em> will be read from above the first group in the file.
1671 </p>
1672 <div class="variablelist"><table border="0">
1673 <col align="left" valign="top">
1674 <tbody>
1675 <tr>
1676 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1677 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1678 </td>
1679 </tr>
1680 <tr>
1681 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1682 <td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1683 </td>
1684 </tr>
1685 <tr>
1686 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1687 <td>a key</td>
1688 </tr>
1689 <tr>
1690 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1691 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
1692 </td>
1693 </tr>
1694 <tr>
1695 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1696 <td>a comment that should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>
1697 </td>
1698 </tr>
1699 </tbody>
1700 </table></div>
1701 <p class="since">Since 2.6</p>
1702 </div>
1703 <hr>
1704 <div class="refsect2">
1705 <a name="g-key-file-set-value"></a><h3>g_key_file_set_value ()</h3>
1706 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_value                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1707                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1708                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1709                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1710 <p>
1711 Associates a new value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1712 </p>
1713 <p>
1714 If <em class="parameter"><code>key</code></em> cannot be found then it is created. If <em class="parameter"><code>group_name</code></em> cannot
1715 be found then it is created. To set an UTF-8 string which may contain
1716 characters that need escaping (such as newlines or spaces), use
1717 <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-string" title="g_key_file_set_string ()"><code class="function">g_key_file_set_string()</code></a>.
1718 </p>
1719 <div class="variablelist"><table border="0">
1720 <col align="left" valign="top">
1721 <tbody>
1722 <tr>
1723 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1724 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1725 </td>
1726 </tr>
1727 <tr>
1728 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1729 <td>a group name</td>
1730 </tr>
1731 <tr>
1732 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1733 <td>a key</td>
1734 </tr>
1735 <tr>
1736 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1737 <td>a string</td>
1738 </tr>
1739 </tbody>
1740 </table></div>
1741 <p class="since">Since 2.6</p>
1742 </div>
1743 <hr>
1744 <div class="refsect2">
1745 <a name="g-key-file-set-string"></a><h3>g_key_file_set_string ()</h3>
1746 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_string               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1747                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1748                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1749                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1750 <p>
1751 Associates a new string value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1752 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
1753 If <em class="parameter"><code>group_name</code></em> cannot be found then it is created.
1754 Unlike <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-value" title="g_key_file_set_value ()"><code class="function">g_key_file_set_value()</code></a>, this function handles characters
1755 that need escaping, such as newlines.
1756 </p>
1757 <div class="variablelist"><table border="0">
1758 <col align="left" valign="top">
1759 <tbody>
1760 <tr>
1761 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1762 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1763 </td>
1764 </tr>
1765 <tr>
1766 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1767 <td>a group name</td>
1768 </tr>
1769 <tr>
1770 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1771 <td>a key</td>
1772 </tr>
1773 <tr>
1774 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1775 <td>a string</td>
1776 </tr>
1777 </tbody>
1778 </table></div>
1779 <p class="since">Since 2.6</p>
1780 </div>
1781 <hr>
1782 <div class="refsect2">
1783 <a name="g-key-file-set-locale-string"></a><h3>g_key_file_set_locale_string ()</h3>
1784 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_locale_string        (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1785                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1786                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1787                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
1788                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1789 <p>
1790 Associates a string value for <em class="parameter"><code>key</code></em> and <em class="parameter"><code>locale</code></em> under <em class="parameter"><code>group_name</code></em>.
1791 If the translation for <em class="parameter"><code>key</code></em> cannot be found then it is created.
1792 </p>
1793 <div class="variablelist"><table border="0">
1794 <col align="left" valign="top">
1795 <tbody>
1796 <tr>
1797 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1798 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1799 </td>
1800 </tr>
1801 <tr>
1802 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1803 <td>a group name</td>
1804 </tr>
1805 <tr>
1806 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1807 <td>a key</td>
1808 </tr>
1809 <tr>
1810 <td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
1811 <td>a locale identifier</td>
1812 </tr>
1813 <tr>
1814 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1815 <td>a string</td>
1816 </tr>
1817 </tbody>
1818 </table></div>
1819 <p class="since">Since 2.6</p>
1820 </div>
1821 <hr>
1822 <div class="refsect2">
1823 <a name="g-key-file-set-boolean"></a><h3>g_key_file_set_boolean ()</h3>
1824 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_boolean              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1825                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1826                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1827                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
1828 <p>
1829 Associates a new boolean value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1830 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
1831 </p>
1832 <div class="variablelist"><table border="0">
1833 <col align="left" valign="top">
1834 <tbody>
1835 <tr>
1836 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1837 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1838 </td>
1839 </tr>
1840 <tr>
1841 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1842 <td>a group name</td>
1843 </tr>
1844 <tr>
1845 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1846 <td>a key</td>
1847 </tr>
1848 <tr>
1849 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1850 <td>
1851 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
1852 </td>
1853 </tr>
1854 </tbody>
1855 </table></div>
1856 <p class="since">Since 2.6</p>
1857 </div>
1858 <hr>
1859 <div class="refsect2">
1860 <a name="g-key-file-set-integer"></a><h3>g_key_file_set_integer ()</h3>
1861 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_integer              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1862                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1863                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1864                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> value</code></em>);</pre>
1865 <p>
1866 Associates a new integer value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1867 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
1868 </p>
1869 <div class="variablelist"><table border="0">
1870 <col align="left" valign="top">
1871 <tbody>
1872 <tr>
1873 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1874 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1875 </td>
1876 </tr>
1877 <tr>
1878 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1879 <td>a group name</td>
1880 </tr>
1881 <tr>
1882 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1883 <td>a key</td>
1884 </tr>
1885 <tr>
1886 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1887 <td>an integer value</td>
1888 </tr>
1889 </tbody>
1890 </table></div>
1891 <p class="since">Since 2.6</p>
1892 </div>
1893 <hr>
1894 <div class="refsect2">
1895 <a name="g-key-file-set-int64"></a><h3>g_key_file_set_int64 ()</h3>
1896 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_int64                (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1897                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1898                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1899                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> value</code></em>);</pre>
1900 <p>
1901 Associates a new integer value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1902 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
1903 </p>
1904 <div class="variablelist"><table border="0">
1905 <col align="left" valign="top">
1906 <tbody>
1907 <tr>
1908 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1909 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1910 </td>
1911 </tr>
1912 <tr>
1913 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1914 <td>a group name</td>
1915 </tr>
1916 <tr>
1917 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1918 <td>a key</td>
1919 </tr>
1920 <tr>
1921 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1922 <td>an integer value</td>
1923 </tr>
1924 </tbody>
1925 </table></div>
1926 <p class="since">Since 2.26</p>
1927 </div>
1928 <hr>
1929 <div class="refsect2">
1930 <a name="g-key-file-set-uint64"></a><h3>g_key_file_set_uint64 ()</h3>
1931 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_uint64               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1932                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1933                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1934                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> value</code></em>);</pre>
1935 <p>
1936 Associates a new integer value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1937 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
1938 </p>
1939 <div class="variablelist"><table border="0">
1940 <col align="left" valign="top">
1941 <tbody>
1942 <tr>
1943 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1944 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1945 </td>
1946 </tr>
1947 <tr>
1948 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1949 <td>a group name</td>
1950 </tr>
1951 <tr>
1952 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1953 <td>a key</td>
1954 </tr>
1955 <tr>
1956 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1957 <td>an integer value</td>
1958 </tr>
1959 </tbody>
1960 </table></div>
1961 <p class="since">Since 2.26</p>
1962 </div>
1963 <hr>
1964 <div class="refsect2">
1965 <a name="g-key-file-set-double"></a><h3>g_key_file_set_double ()</h3>
1966 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_double               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
1967                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
1968                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
1969                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> value</code></em>);</pre>
1970 <p>
1971 Associates a new double value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
1972 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
1973 </p>
1974 <div class="variablelist"><table border="0">
1975 <col align="left" valign="top">
1976 <tbody>
1977 <tr>
1978 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
1979 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
1980 </td>
1981 </tr>
1982 <tr>
1983 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
1984 <td>a group name</td>
1985 </tr>
1986 <tr>
1987 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1988 <td>a key</td>
1989 </tr>
1990 <tr>
1991 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1992 <td>an double value</td>
1993 </tr>
1994 </tbody>
1995 </table></div>
1996 <p class="since">Since 2.12</p>
1997 </div>
1998 <hr>
1999 <div class="refsect2">
2000 <a name="g-key-file-set-string-list"></a><h3>g_key_file_set_string_list ()</h3>
2001 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_string_list          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2002                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2003                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2004                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> * const list[]</code></em>,
2005                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
2006 <p>
2007 Associates a list of string values for <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
2008 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
2009 If <em class="parameter"><code>group_name</code></em> cannot be found then it is created.
2010 </p>
2011 <div class="variablelist"><table border="0">
2012 <col align="left" valign="top">
2013 <tbody>
2014 <tr>
2015 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2016 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2017 </td>
2018 </tr>
2019 <tr>
2020 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2021 <td>a group name</td>
2022 </tr>
2023 <tr>
2024 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2025 <td>a key</td>
2026 </tr>
2027 <tr>
2028 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2029 <td>an array of string values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
2030 </td>
2031 </tr>
2032 <tr>
2033 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
2034 <td>number of string values in <em class="parameter"><code>list</code></em>
2035 </td>
2036 </tr>
2037 </tbody>
2038 </table></div>
2039 <p class="since">Since 2.6</p>
2040 </div>
2041 <hr>
2042 <div class="refsect2">
2043 <a name="g-key-file-set-locale-string-list"></a><h3>g_key_file_set_locale_string_list ()</h3>
2044 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_locale_string_list   (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2045                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2046                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2047                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>,
2048                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> * const list[]</code></em>,
2049                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
2050 <p>
2051 Associates a list of string values for <em class="parameter"><code>key</code></em> and <em class="parameter"><code>locale</code></em> under
2052 <em class="parameter"><code>group_name</code></em>.  If the translation for <em class="parameter"><code>key</code></em> cannot be found then
2053 it is created.
2054 </p>
2055 <div class="variablelist"><table border="0">
2056 <col align="left" valign="top">
2057 <tbody>
2058 <tr>
2059 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2060 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2061 </td>
2062 </tr>
2063 <tr>
2064 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2065 <td>a group name</td>
2066 </tr>
2067 <tr>
2068 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2069 <td>a key</td>
2070 </tr>
2071 <tr>
2072 <td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
2073 <td>a locale identifier</td>
2074 </tr>
2075 <tr>
2076 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2077 <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of locale string values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length]</span>
2078 </td>
2079 </tr>
2080 <tr>
2081 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
2082 <td>the length of <em class="parameter"><code>list</code></em>
2083 </td>
2084 </tr>
2085 </tbody>
2086 </table></div>
2087 <p class="since">Since 2.6</p>
2088 </div>
2089 <hr>
2090 <div class="refsect2">
2091 <a name="g-key-file-set-boolean-list"></a><h3>g_key_file_set_boolean_list ()</h3>
2092 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_boolean_list         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2093                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2094                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2095                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> list[]</code></em>,
2096                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
2097 <p>
2098 Associates a list of boolean values with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
2099 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
2100 If <em class="parameter"><code>group_name</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the start_group is used.
2101 </p>
2102 <div class="variablelist"><table border="0">
2103 <col align="left" valign="top">
2104 <tbody>
2105 <tr>
2106 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2107 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2108 </td>
2109 </tr>
2110 <tr>
2111 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2112 <td>a group name</td>
2113 </tr>
2114 <tr>
2115 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2116 <td>a key</td>
2117 </tr>
2118 <tr>
2119 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2120 <td>an array of boolean values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
2121 </td>
2122 </tr>
2123 <tr>
2124 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
2125 <td>length of <em class="parameter"><code>list</code></em>
2126 </td>
2127 </tr>
2128 </tbody>
2129 </table></div>
2130 <p class="since">Since 2.6</p>
2131 </div>
2132 <hr>
2133 <div class="refsect2">
2134 <a name="g-key-file-set-integer-list"></a><h3>g_key_file_set_integer_list ()</h3>
2135 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_integer_list         (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2136                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2137                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2138                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> list[]</code></em>,
2139                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
2140 <p>
2141 Associates a list of integer values with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
2142 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
2143 </p>
2144 <div class="variablelist"><table border="0">
2145 <col align="left" valign="top">
2146 <tbody>
2147 <tr>
2148 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2149 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2150 </td>
2151 </tr>
2152 <tr>
2153 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2154 <td>a group name</td>
2155 </tr>
2156 <tr>
2157 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2158 <td>a key</td>
2159 </tr>
2160 <tr>
2161 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2162 <td>an array of integer values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
2163 </td>
2164 </tr>
2165 <tr>
2166 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
2167 <td>number of integer values in <em class="parameter"><code>list</code></em>
2168 </td>
2169 </tr>
2170 </tbody>
2171 </table></div>
2172 <p class="since">Since 2.6</p>
2173 </div>
2174 <hr>
2175 <div class="refsect2">
2176 <a name="g-key-file-set-double-list"></a><h3>g_key_file_set_double_list ()</h3>
2177 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_double_list          (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2178                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2179                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2180                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> list[]</code></em>,
2181                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
2182 <p>
2183 Associates a list of double values with <em class="parameter"><code>key</code></em> under
2184 <em class="parameter"><code>group_name</code></em>.  If <em class="parameter"><code>key</code></em> cannot be found then it is created.
2185 </p>
2186 <div class="variablelist"><table border="0">
2187 <col align="left" valign="top">
2188 <tbody>
2189 <tr>
2190 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2191 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2192 </td>
2193 </tr>
2194 <tr>
2195 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2196 <td>a group name</td>
2197 </tr>
2198 <tr>
2199 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2200 <td>a key</td>
2201 </tr>
2202 <tr>
2203 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
2204 <td>an array of double values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
2205 </td>
2206 </tr>
2207 <tr>
2208 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
2209 <td>number of double values in <em class="parameter"><code>list</code></em>
2210 </td>
2211 </tr>
2212 </tbody>
2213 </table></div>
2214 <p class="since">Since 2.12</p>
2215 </div>
2216 <hr>
2217 <div class="refsect2">
2218 <a name="g-key-file-set-comment"></a><h3>g_key_file_set_comment ()</h3>
2219 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_set_comment              (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2220                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2221                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2222                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *comment</code></em>,
2223                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2224 <p>
2225 Places a comment above <em class="parameter"><code>key</code></em> from <em class="parameter"><code>group_name</code></em>.
2226 If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then <em class="parameter"><code>comment</code></em> will be written above <em class="parameter"><code>group_name</code></em>.
2227 If both <em class="parameter"><code>key</code></em> and <em class="parameter"><code>group_name</code></em>  are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <em class="parameter"><code>comment</code></em> will be
2228 written above the first group in the file.
2229 </p>
2230 <div class="variablelist"><table border="0">
2231 <col align="left" valign="top">
2232 <tbody>
2233 <tr>
2234 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2235 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2236 </td>
2237 </tr>
2238 <tr>
2239 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2240 <td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2241 </td>
2242 </tr>
2243 <tr>
2244 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2245 <td>a key. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2246 </td>
2247 </tr>
2248 <tr>
2249 <td><p><span class="term"><em class="parameter"><code>comment</code></em> :</span></p></td>
2250 <td>a comment</td>
2251 </tr>
2252 <tr>
2253 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2254 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
2255 </td>
2256 </tr>
2257 <tr>
2258 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2259 <td>
2260 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the comment was written, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
2261 </tr>
2262 </tbody>
2263 </table></div>
2264 <p class="since">Since 2.6</p>
2265 </div>
2266 <hr>
2267 <div class="refsect2">
2268 <a name="g-key-file-remove-group"></a><h3>g_key_file_remove_group ()</h3>
2269 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_remove_group             (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2270                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2271                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2272 <p>
2273 Removes the specified group, <em class="parameter"><code>group_name</code></em>,
2274 from the key file.
2275 </p>
2276 <div class="variablelist"><table border="0">
2277 <col align="left" valign="top">
2278 <tbody>
2279 <tr>
2280 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2281 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2282 </td>
2283 </tr>
2284 <tr>
2285 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2286 <td>a group name</td>
2287 </tr>
2288 <tr>
2289 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2290 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2291 </td>
2292 </tr>
2293 <tr>
2294 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2295 <td>
2296 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the group was removed, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
2297 </tr>
2298 </tbody>
2299 </table></div>
2300 <p class="since">Since 2.6</p>
2301 </div>
2302 <hr>
2303 <div class="refsect2">
2304 <a name="g-key-file-remove-key"></a><h3>g_key_file_remove_key ()</h3>
2305 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_remove_key               (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2306                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2307                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2308                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2309 <p>
2310 Removes <em class="parameter"><code>key</code></em> in <em class="parameter"><code>group_name</code></em> from the key file.
2311 </p>
2312 <div class="variablelist"><table border="0">
2313 <col align="left" valign="top">
2314 <tbody>
2315 <tr>
2316 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2317 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2318 </td>
2319 </tr>
2320 <tr>
2321 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2322 <td>a group name</td>
2323 </tr>
2324 <tr>
2325 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2326 <td>a key name to remove</td>
2327 </tr>
2328 <tr>
2329 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2330 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2331 </td>
2332 </tr>
2333 <tr>
2334 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2335 <td>
2336 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key was removed, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
2337 </tr>
2338 </tbody>
2339 </table></div>
2340 <p class="since">Since 2.6</p>
2341 </div>
2342 <hr>
2343 <div class="refsect2">
2344 <a name="g-key-file-remove-comment"></a><h3>g_key_file_remove_comment ()</h3>
2345 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_key_file_remove_comment           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
2346                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group_name</code></em>,
2347                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *key</code></em>,
2348                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2349 <p>
2350 Removes a comment above <em class="parameter"><code>key</code></em> from <em class="parameter"><code>group_name</code></em>.
2351 If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then <em class="parameter"><code>comment</code></em> will be removed above <em class="parameter"><code>group_name</code></em>.
2352 If both <em class="parameter"><code>key</code></em> and <em class="parameter"><code>group_name</code></em> are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <em class="parameter"><code>comment</code></em> will
2353 be removed above the first group in the file.
2354 </p>
2355 <div class="variablelist"><table border="0">
2356 <col align="left" valign="top">
2357 <tbody>
2358 <tr>
2359 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
2360 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
2361 </td>
2362 </tr>
2363 <tr>
2364 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
2365 <td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2366 </td>
2367 </tr>
2368 <tr>
2369 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2370 <td>a key. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2371 </td>
2372 </tr>
2373 <tr>
2374 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2375 <td>return location for a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>
2376 </td>
2377 </tr>
2378 <tr>
2379 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2380 <td>
2381 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the comment was removed, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</td>
2382 </tr>
2383 </tbody>
2384 </table></div>
2385 <p class="since">Since 2.6</p>
2386 </div>
2387 <hr>
2388 <div class="refsect2">
2389 <a name="G-KEY-FILE-DESKTOP-GROUP:CAPS"></a><h3>G_KEY_FILE_DESKTOP_GROUP</h3>
2390 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_GROUP                "Desktop Entry"
2391 </pre>
2392 <p>
2393 The name of the main group of a desktop entry file, as defined in the
2394 <a class="ulink" href="http://freedesktop.org/Standards/desktop-entry-spec" target="_top">Desktop
2395 Entry Specification</a>. Consult the specification for more
2396 details about the meanings of the keys below.
2397 </p>
2398 <p class="since">Since 2.14</p>
2399 </div>
2400 <hr>
2401 <div class="refsect2">
2402 <a name="G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_TYPE</h3>
2403 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_TYPE             "Type"
2404 </pre>
2405 <p>
2406 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
2407 giving the type of the desktop entry. Usually
2408 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-APPLICATION:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_APPLICATION"><span class="type">G_KEY_FILE_DESKTOP_TYPE_APPLICATION</span></a>,
2409 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-LINK:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_LINK"><span class="type">G_KEY_FILE_DESKTOP_TYPE_LINK</span></a>, or
2410 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-DIRECTORY:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_DIRECTORY"><span class="type">G_KEY_FILE_DESKTOP_TYPE_DIRECTORY</span></a>.
2411 </p>
2412 <p class="since">Since 2.14</p>
2413 </div>
2414 <hr>
2415 <div class="refsect2">
2416 <a name="G-KEY-FILE-DESKTOP-KEY-VERSION:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_VERSION</h3>
2417 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_VERSION          "Version"
2418 </pre>
2419 <p>
2420 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
2421 giving the version of the Desktop Entry Specification used for
2422 the desktop entry file.
2423 </p>
2424 <p class="since">Since 2.14</p>
2425 </div>
2426 <hr>
2427 <div class="refsect2">
2428 <a name="G-KEY-FILE-DESKTOP-KEY-NAME:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_NAME</h3>
2429 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_NAME             "Name"
2430 </pre>
2431 <p>
2432 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
2433 string giving the specific name of the desktop entry.
2434 </p>
2435 <p class="since">Since 2.14</p>
2436 </div>
2437 <hr>
2438 <div class="refsect2">
2439 <a name="G-KEY-FILE-DESKTOP-KEY-GENERIC-NAME:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME</h3>
2440 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME     "GenericName"
2441 </pre>
2442 <p>
2443 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
2444 string giving the generic name of the desktop entry.
2445 </p>
2446 <p class="since">Since 2.14</p>
2447 </div>
2448 <hr>
2449 <div class="refsect2">
2450 <a name="G-KEY-FILE-DESKTOP-KEY-NO-DISPLAY:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY</h3>
2451 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY       "NoDisplay"
2452 </pre>
2453 <p>
2454 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
2455 stating whether the desktop entry should be shown in menus.
2456 </p>
2457 <p class="since">Since 2.14</p>
2458 </div>
2459 <hr>
2460 <div class="refsect2">
2461 <a name="G-KEY-FILE-DESKTOP-KEY-COMMENT:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_COMMENT</h3>
2462 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_COMMENT          "Comment"
2463 </pre>
2464 <p>
2465 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
2466 string giving the tooltip for the desktop entry.
2467 </p>
2468 <p class="since">Since 2.14</p>
2469 </div>
2470 <hr>
2471 <div class="refsect2">
2472 <a name="G-KEY-FILE-DESKTOP-KEY-ICON:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_ICON</h3>
2473 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_ICON             "Icon"
2474 </pre>
2475 <p>
2476 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
2477 string giving the name of the icon to be displayed for the desktop
2478 entry.
2479 </p>
2480 <p class="since">Since 2.14</p>
2481 </div>
2482 <hr>
2483 <div class="refsect2">
2484 <a name="G-KEY-FILE-DESKTOP-KEY-HIDDEN:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_HIDDEN</h3>
2485 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_HIDDEN           "Hidden"
2486 </pre>
2487 <p>
2488 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
2489 stating whether the desktop entry has been deleted by the user.
2490 </p>
2491 <p class="since">Since 2.14</p>
2492 </div>
2493 <hr>
2494 <div class="refsect2">
2495 <a name="G-KEY-FILE-DESKTOP-KEY-ONLY-SHOW-IN:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN</h3>
2496 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN     "OnlyShowIn"
2497 </pre>
2498 <p>
2499 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list of
2500 strings identifying the environments that should display the
2501 desktop entry.
2502 </p>
2503 <p class="since">Since 2.14</p>
2504 </div>
2505 <hr>
2506 <div class="refsect2">
2507 <a name="G-KEY-FILE-DESKTOP-KEY-NOT-SHOW-IN:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN</h3>
2508 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN      "NotShowIn"
2509 </pre>
2510 <p>
2511 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list of
2512 strings identifying the environments that should not display the
2513 desktop entry.
2514 </p>
2515 <p class="since">Since 2.14</p>
2516 </div>
2517 <hr>
2518 <div class="refsect2">
2519 <a name="G-KEY-FILE-DESKTOP-KEY-TRY-EXEC:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_TRY_EXEC</h3>
2520 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_TRY_EXEC         "TryExec"
2521 </pre>
2522 <p>
2523 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
2524 giving the file name of a binary on disk used to determine if the
2525 program is actually installed. It is only valid for desktop entries
2526 with the <code class="literal">Application</code> type.
2527 </p>
2528 <p class="since">Since 2.14</p>
2529 </div>
2530 <hr>
2531 <div class="refsect2">
2532 <a name="G-KEY-FILE-DESKTOP-KEY-EXEC:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_EXEC</h3>
2533 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_EXEC             "Exec"
2534 </pre>
2535 <p>
2536 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
2537 giving the command line to execute. It is only valid for desktop
2538 entries with the <code class="literal">Application</code> type.
2539 </p>
2540 <p class="since">Since 2.14</p>
2541 </div>
2542 <hr>
2543 <div class="refsect2">
2544 <a name="G-KEY-FILE-DESKTOP-KEY-PATH:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_PATH</h3>
2545 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_PATH             "Path"
2546 </pre>
2547 <p>
2548 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
2549 containing the working directory to run the program in. It is only
2550 valid for desktop entries with the <code class="literal">Application</code> type.
2551 </p>
2552 <p class="since">Since 2.14</p>
2553 </div>
2554 <hr>
2555 <div class="refsect2">
2556 <a name="G-KEY-FILE-DESKTOP-KEY-TERMINAL:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_TERMINAL</h3>
2557 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_TERMINAL         "Terminal"
2558 </pre>
2559 <p>
2560 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
2561 stating whether the program should be run in a terminal window.
2562 It is only valid for desktop entries with the
2563 <code class="literal">Application</code> type.
2564 </p>
2565 <p class="since">Since 2.14</p>
2566 </div>
2567 <hr>
2568 <div class="refsect2">
2569 <a name="G-KEY-FILE-DESKTOP-KEY-MIME-TYPE:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_MIME_TYPE</h3>
2570 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_MIME_TYPE        "MimeType"
2571 </pre>
2572 <p>
2573 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list
2574 of strings giving the MIME types supported by this desktop entry.
2575 </p>
2576 <p class="since">Since 2.14</p>
2577 </div>
2578 <hr>
2579 <div class="refsect2">
2580 <a name="G-KEY-FILE-DESKTOP-KEY-CATEGORIES:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_CATEGORIES</h3>
2581 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_CATEGORIES       "Categories"
2582 </pre>
2583 <p>
2584 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list
2585 of strings giving the categories in which the desktop entry
2586 should be shown in a menu.
2587 </p>
2588 <p class="since">Since 2.14</p>
2589 </div>
2590 <hr>
2591 <div class="refsect2">
2592 <a name="G-KEY-FILE-DESKTOP-KEY-STARTUP-NOTIFY:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY</h3>
2593 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY   "StartupNotify"
2594 </pre>
2595 <p>
2596 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
2597 stating whether the application supports the <a class="ulink" href="http://www.freedesktop.org/Standards/startup-notification-spec" target="_top">Startup
2598 Notification Protocol Specification</a>.
2599 </p>
2600 <p class="since">Since 2.14</p>
2601 </div>
2602 <hr>
2603 <div class="refsect2">
2604 <a name="G-KEY-FILE-DESKTOP-KEY-STARTUP-WM-CLASS:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS</h3>
2605 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS "StartupWMClass"
2606 </pre>
2607 <p>
2608 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is string
2609 identifying the WM class or name hint of a window that the application
2610 will create, which can be used to emulate Startup Notification with
2611 older applications.
2612 </p>
2613 <p class="since">Since 2.14</p>
2614 </div>
2615 <hr>
2616 <div class="refsect2">
2617 <a name="G-KEY-FILE-DESKTOP-KEY-URL:CAPS"></a><h3>G_KEY_FILE_DESKTOP_KEY_URL</h3>
2618 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_URL              "URL"
2619 </pre>
2620 <p>
2621 A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
2622 giving the URL to access. It is only valid for desktop entries
2623 with the <code class="literal">Link</code> type.
2624 </p>
2625 <p class="since">Since 2.14</p>
2626 </div>
2627 <hr>
2628 <div class="refsect2">
2629 <a name="G-KEY-FILE-DESKTOP-TYPE-APPLICATION:CAPS"></a><h3>G_KEY_FILE_DESKTOP_TYPE_APPLICATION</h3>
2630 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_TYPE_APPLICATION     "Application"
2631 </pre>
2632 <p>
2633 The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><span class="type">G_KEY_FILE_DESKTOP_KEY_TYPE</span></a>, key for desktop
2634 entries representing applications.
2635 </p>
2636 <p class="since">Since 2.14</p>
2637 </div>
2638 <hr>
2639 <div class="refsect2">
2640 <a name="G-KEY-FILE-DESKTOP-TYPE-LINK:CAPS"></a><h3>G_KEY_FILE_DESKTOP_TYPE_LINK</h3>
2641 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_TYPE_LINK            "Link"
2642 </pre>
2643 <p>
2644 The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><span class="type">G_KEY_FILE_DESKTOP_KEY_TYPE</span></a>, key for desktop
2645 entries representing links to documents.
2646 </p>
2647 <p class="since">Since 2.14</p>
2648 </div>
2649 <hr>
2650 <div class="refsect2">
2651 <a name="G-KEY-FILE-DESKTOP-TYPE-DIRECTORY:CAPS"></a><h3>G_KEY_FILE_DESKTOP_TYPE_DIRECTORY</h3>
2652 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_TYPE_DIRECTORY       "Directory"
2653 </pre>
2654 <p>
2655 The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><span class="type">G_KEY_FILE_DESKTOP_KEY_TYPE</span></a>, key for desktop
2656 entries representing directories.
2657 </p>
2658 <p class="since">Since 2.14</p>
2659 </div>
2660 </div>
2661 </div>
2662 <div class="footer">
2663 <hr>
2664           Generated by GTK-Doc V1.18</div>
2665 </body>
2666 </html>