glib-key-value-file-parser.html

最新gtk中文资料集

<p>
The <span class="structname">GKeyFile</span> struct contains only private fields
and should not be used directly.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3173616"></a><h3>
<a name="G-KEY-FILE-ERROR:CAPS"></a>G_KEY_FILE_ERROR</h3>
<a class="indexterm" name="id3173630"></a><pre class="programlisting">#define G_KEY_FILE_ERROR g_key_file_error_quark()
</pre>
<p>
Error domain for key file parsing. Errors in this domain will
be from the <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError"><span class="type">GKeyFileError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for information on 
error domains.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3173664"></a><h3>
<a name="GKeyFileError"></a>enum GKeyFileError</h3>
<a class="indexterm" name="id3173676"></a><pre class="programlisting">typedef enum
{
  G_KEY_FILE_ERROR_UNKNOWN_ENCODING,
  G_KEY_FILE_ERROR_PARSE,
  G_KEY_FILE_ERROR_NOT_FOUND,
  G_KEY_FILE_ERROR_KEY_NOT_FOUND,
  G_KEY_FILE_ERROR_GROUP_NOT_FOUND,
  G_KEY_FILE_ERROR_INVALID_VALUE
} GKeyFileError;
</pre>
<p>
Error codes returned by key file parsing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-ERROR-UNKNOWN-ENCODING:CAPS"></a><code class="literal">G_KEY_FILE_ERROR_UNKNOWN_ENCODING</code></span></p></td>
<td>the text being parsed was in an unknown encoding
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-ERROR-PARSE:CAPS"></a><code class="literal">G_KEY_FILE_ERROR_PARSE</code></span></p></td>
<td>document was ill-formed
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-ERROR-NOT-FOUND:CAPS"></a><code class="literal">G_KEY_FILE_ERROR_NOT_FOUND</code></span></p></td>
<td>the file was not found
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-ERROR-KEY-NOT-FOUND:CAPS"></a><code class="literal">G_KEY_FILE_ERROR_KEY_NOT_FOUND</code></span></p></td>
<td>a requested key was not found
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"></a><code class="literal">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</code></span></p></td>
<td>a requested group was not found
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"></a><code class="literal">G_KEY_FILE_ERROR_INVALID_VALUE</code></span></p></td>
<td>a value could not be parsed

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3173840"></a><h3>
<a name="GKeyFileFlags"></a>enum GKeyFileFlags</h3>
<a class="indexterm" name="id3173852"></a><pre class="programlisting">typedef enum
{
  G_KEY_FILE_NONE              = 0,
  G_KEY_FILE_KEEP_COMMENTS     = 1 &lt;&lt; 0,
  G_KEY_FILE_KEEP_TRANSLATIONS = 1 &lt;&lt; 1
} GKeyFileFlags;
</pre>
<p>
Flags which influence the parsing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-NONE:CAPS"></a><code class="literal">G_KEY_FILE_NONE</code></span></p></td>
<td>No flags, default behaviour
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-KEEP-COMMENTS:CAPS"></a><code class="literal">G_KEY_FILE_KEEP_COMMENTS</code></span></p></td>
<td>Use this flag if you plan to write the (possibly modified)
  contents of the key file back to a file; otherwise all comments will be lost when
  the key file is written back.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-KEY-FILE-KEEP-TRANSLATIONS:CAPS"></a><code class="literal">G_KEY_FILE_KEEP_TRANSLATIONS</code></span></p></td>
<td>Use this flag if you plan to write the (possibly modified)
  contents of the key file back to a file; otherwise only the translations for the current
  language will be written back.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3173948"></a><h3>
<a name="g-key-file-new"></a>g_key_file_new ()</h3>
<a class="indexterm" name="id3173964"></a><pre class="programlisting"><a class="link" href="glib-Key-value-file-parser.html#GKeyFile">GKeyFile</a>*           g_key_file_new                      (void);</pre>
<p>
Creates a new empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile"><span class="type">GKeyFile</span></a> object. Use
<a class="link" href="glib-Key-value-file-parser.html#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"><code class="function">g_key_file_load_from_data()</code></a>,
<a class="link" href="glib-Key-value-file-parser.html#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"><code class="function">g_key_file_load_from_data_dirs()</code></a> to
read an existing key file.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile"><span class="type">GKeyFile</span></a>.

</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3174071"></a><h3>
<a name="g-key-file-free"></a>g_key_file_free ()</h3>
<a class="indexterm" name="id3174086"></a><pre class="programlisting">void                g_key_file_free                     (<a class="link" href="glib-Key-value-file-parser.html#GKeyFile">GKeyFile</a> *key_file);</pre>
<p>
Frees a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile"><span class="type">GKeyFile</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>key_file</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile"><span class="type">GKeyFile</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3174158"></a><h3>
<a name="g-key-file-set-list-separator"></a>g_key_file_set_list_separator ()</h3>
<a class="indexterm" name="id3174173"></a><pre class="programlisting">void                g_key_file_set_list_separator       (<a class="link" href="glib-Key-value-file-parser.html#GKeyFile">GKeyFile</a> *key_file,
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> separator);</pre>
<p>
Sets the character which is used to separate
values in lists. Typically ';' or ',' are used
as separators. The default list separator is ';'.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>key_file</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile"><span class="type">GKeyFile</span></a> 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>separator</code></em>&#160;:</span></p></td>