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