docs/reference/glib/html/glib-Bookmark-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>Bookmark 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-Key-value-file-parser.html" title="Key-value file parser">
  10 <link rel="next" href="glib-Testing.html" title="Testing">
  11 <meta name="generator" content="GTK-Doc V1.15 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="glib-Key-value-file-parser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="glib-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GLib Reference Manual</th>
  21 <td><a accesskey="n" href="glib-Testing.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#glib-Bookmark-file-parser.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#glib-Bookmark-file-parser.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry" title="Bookmark file parser">
  30 <a name="glib-Bookmark-file-parser"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="glib-Bookmark-file-parser.top_of_page"></a>Bookmark file parser</span></h2>
  34 <p>Bookmark file parser — parses files containing bookmarks</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv" title="Synopsis">
  39 <a name="glib-Bookmark-file-parser.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;glib.h&gt;
  42
  43                     <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile">GBookmarkFile</a>;
  44 #define             <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR:CAPS" title="G_BOOKMARK_FILE_ERROR">G_BOOKMARK_FILE_ERROR</a>
  45 enum                <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFileError" title="enum GBookmarkFileError">GBookmarkFileError</a>;
  46 <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="returnvalue">GBookmarkFile</span></a> *     <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-new" title="g_bookmark_file_new ()">g_bookmark_file_new</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
  47 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-free" title="g_bookmark_file_free ()">g_bookmark_file_free</a>                (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>);
  48 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-load-from-file" title="g_bookmark_file_load_from_file ()">g_bookmark_file_load_from_file</a>      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  49                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>,
  50                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  51 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-load-from-data" title="g_bookmark_file_load_from_data ()">g_bookmark_file_load_from_data</a>      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  52                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *data</code></em>,
  53                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>,
  54                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  55 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-load-from-data-dirs" title="g_bookmark_file_load_from_data_dirs ()">g_bookmark_file_load_from_data_dirs</a> (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  56                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
  57                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **full_path</code></em>,
  58                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  59 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-to-data" title="g_bookmark_file_to_data ()">g_bookmark_file_to_data</a>             (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  60                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
  61                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  62 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-to-file" title="g_bookmark_file_to_file ()">g_bookmark_file_to_file</a>             (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  63                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>,
  64                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  65 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-has-item" title="g_bookmark_file_has_item ()">g_bookmark_file_has_item</a>            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  66                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>);
  67 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-has-group" title="g_bookmark_file_has_group ()">g_bookmark_file_has_group</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  68                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  69                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group</code></em>,
  70                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  71 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-has-application" title="g_bookmark_file_has_application ()">g_bookmark_file_has_application</a>     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  72                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  73                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
  74                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  75 <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-size" title="g_bookmark_file_get_size ()">g_bookmark_file_get_size</a>            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>);
  76 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-uris" title="g_bookmark_file_get_uris ()">g_bookmark_file_get_uris</a>            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  77                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);
  78
  79 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-title" title="g_bookmark_file_get_title ()">g_bookmark_file_get_title</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  80                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  81                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  82 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-description" title="g_bookmark_file_get_description ()">g_bookmark_file_get_description</a>     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  83                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  84                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  85 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-mime-type" title="g_bookmark_file_get_mime_type ()">g_bookmark_file_get_mime_type</a>       (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  86                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  87                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  88 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-is-private" title="g_bookmark_file_get_is_private ()">g_bookmark_file_get_is_private</a>      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  89                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  90                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  91 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-icon" title="g_bookmark_file_get_icon ()">g_bookmark_file_get_icon</a>            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  92                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  93                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **href</code></em>,
  94                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **mime_type</code></em>,
  95                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  96 <span class="returnvalue">time_t</span>              <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-added" title="g_bookmark_file_get_added ()">g_bookmark_file_get_added</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
  97                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
  98                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
  99 <span class="returnvalue">time_t</span>              <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-modified" title="g_bookmark_file_get_modified ()">g_bookmark_file_get_modified</a>        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 100                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 101                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 102 <span class="returnvalue">time_t</span>              <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-visited" title="g_bookmark_file_get_visited ()">g_bookmark_file_get_visited</a>         (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 103                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 104                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 105 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-groups" title="g_bookmark_file_get_groups ()">g_bookmark_file_get_groups</a>          (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 106                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 107                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 108                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 109 <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-applications" title="g_bookmark_file_get_applications ()">g_bookmark_file_get_applications</a>    (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 110                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 111                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 112                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 113 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-app-info" title="g_bookmark_file_get_app_info ()">g_bookmark_file_get_app_info</a>        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 114                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 115                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
 116                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **exec</code></em>,
 117                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> *count</code></em>,
 118                                                          <em class="parameter"><code><span class="type">time_t</span> *stamp</code></em>,
 119                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 120
 121 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-title" title="g_bookmark_file_set_title ()">g_bookmark_file_set_title</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 122                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 123                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *title</code></em>);
 124 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-description" title="g_bookmark_file_set_description ()">g_bookmark_file_set_description</a>     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 125                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 126                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *description</code></em>);
 127 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-mime-type" title="g_bookmark_file_set_mime_type ()">g_bookmark_file_set_mime_type</a>       (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 128                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 129                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *mime_type</code></em>);
 130 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-is-private" title="g_bookmark_file_set_is_private ()">g_bookmark_file_set_is_private</a>      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 131                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 132                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> is_private</code></em>);
 133 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-icon" title="g_bookmark_file_set_icon ()">g_bookmark_file_set_icon</a>            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 134                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 135                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *href</code></em>,
 136                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *mime_type</code></em>);
 137 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-added" title="g_bookmark_file_set_added ()">g_bookmark_file_set_added</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 138                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 139                                                          <em class="parameter"><code><span class="type">time_t</span> added</code></em>);
 140 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-groups" title="g_bookmark_file_set_groups ()">g_bookmark_file_set_groups</a>          (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 141                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 142                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **groups</code></em>,
 143                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);
 144 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-modified" title="g_bookmark_file_set_modified ()">g_bookmark_file_set_modified</a>        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 145                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 146                                                          <em class="parameter"><code><span class="type">time_t</span> modified</code></em>);
 147 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-visited" title="g_bookmark_file_set_visited ()">g_bookmark_file_set_visited</a>         (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 148                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 149                                                          <em class="parameter"><code><span class="type">time_t</span> visited</code></em>);
 150 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-app-info" title="g_bookmark_file_set_app_info ()">g_bookmark_file_set_app_info</a>        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 151                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 152                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
 153                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *exec</code></em>,
 154                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> count</code></em>,
 155                                                          <em class="parameter"><code><span class="type">time_t</span> stamp</code></em>,
 156                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 157 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-add-group" title="g_bookmark_file_add_group ()">g_bookmark_file_add_group</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 158                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 159                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group</code></em>);
 160 <span class="returnvalue">void</span>                <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-add-application" title="g_bookmark_file_add_application ()">g_bookmark_file_add_application</a>     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 161                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 162                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
 163                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *exec</code></em>);
 164 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-remove-group" title="g_bookmark_file_remove_group ()">g_bookmark_file_remove_group</a>        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 165                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 166                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group</code></em>,
 167                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 168 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-remove-application" title="g_bookmark_file_remove_application ()">g_bookmark_file_remove_application</a>  (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 169                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 170                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
 171                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 172 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-remove-item" title="g_bookmark_file_remove_item ()">g_bookmark_file_remove_item</a>         (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 173                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 174                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 175 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-move-item" title="g_bookmark_file_move_item ()">g_bookmark_file_move_item</a>           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 176                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *old_uri</code></em>,
 177                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *new_uri</code></em>,
 178                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
 179 </pre>
 180 </div>
 181 <div class="refsect1" title="Description">
 182 <a name="glib-Bookmark-file-parser.description"></a><h2>Description</h2>
 183 <p>
 184 <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> lets you parse, edit or create files containing bookmarks
 185 to URI, along with some meta-data about the resource pointed by the URI like
 186 its MIME type, the application that is registering the bookmark and the
 187 icon that should be used to represent the bookmark. The data is stored using
 188 the
 189 <a class="ulink" href="http://www.gnome.org/~ebassi/bookmark-spec" target="_top">Desktop Bookmark
 190 Specification</a>.
 191 </p>
 192 <p>
 193 The syntax of the bookmark files is described in detail inside the Desktop
 194 Bookmark Specification, here is a quick summary: bookmark files use a sub-class
 195 of the
 196 <a class="ulink" href="" target="_top">XML Bookmark Exchange Language</a> specification, consisting
 197 of valid UTF-8 encoded XML, under the <code class="literal">xbel</code> root element;
 198 each bookmark is stored inside a <code class="literal">bookmark</code> element, using
 199 its URI: no relative paths can be used inside a bookmark file. The bookmark
 200 may have a user defined title and description, to be used instead of the URI.
 201 Under the <code class="literal">metadata</code> element, with its <code class="literal">owner</code>
 202 attribute set to <code class="literal">http://freedesktop.org</code>, is stored the
 203 meta-data about a resource pointed by its URI. The meta-data consists of
 204 the resource's MIME type; the applications that have registered a bookmark;
 205 the groups to which a bookmark belongs to; a visibility flag, used to set
 206 the bookmark as "private" to the applications and groups that has it
 207 registered; the URI and MIME type of an icon, to be used when displaying the
 208 bookmark inside a GUI.
 209 </p>
 210 <div class="informalexample">
 211   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 212     <tbody>
 213       <tr>
 214         <td class="listing_lines" align="right"><pre>1
 215 2
 216 3
 217 4
 218 5
 219 6
 220 7
 221 8
 222 9
 223 10
 224 11
 225 12
 226 13
 227 14
 228 15
 229 16
 230 17
 231 18
 232 19
 233 20
 234 21
 235 22
 236 23</pre></td>
 237         <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="normal">xml version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="symbol">?&gt;</span>
 238 <span class="symbol">&lt;!</span><span class="normal">DOCTYPE xbel PUBLIC</span>
 239 <span class="normal">  </span><span class="string">"+//IDN python.org//DTD XML Bookmark Exchange Language 1.0//EN//XML"</span>
 240 <span class="normal">  </span><span class="string">"http://www.python.org/topics/xml/dtds/xbel-1.0.dtd"</span><span class="symbol">&gt;</span>
 241 <span class="symbol">&lt;</span><span class="normal">xbel version</span><span class="symbol">=</span><span class="string">"1.0"</span>
 242 <span class="normal">      xmlns</span><span class="symbol">:</span><span class="normal">mime</span><span class="symbol">=</span><span class="string">"http://www.freedesktop.org/standards/shared-mime-info"</span>
 243 <span class="normal">      xmlns</span><span class="symbol">:</span><span class="normal">bookmark</span><span class="symbol">=</span><span class="string">"http://www.freedesktop.org/standards/desktop-bookmarks"</span><span class="symbol">&gt;</span>
 244 <span class="normal">  </span><span class="symbol">&lt;</span><span class="normal">bookmark href</span><span class="symbol">=</span><span class="string">"file:///home/ebassi/bookmark-spec/bookmark-spec.xml"</span><span class="symbol">&gt;</span>
 245 <span class="normal">    </span><span class="symbol">&lt;</span><span class="normal">title</span><span class="symbol">&gt;</span><span class="normal">Desktop Bookmarks Spec</span><span class="symbol">&lt;/</span><span class="normal">title</span><span class="symbol">&gt;</span>
 246 <span class="normal">    </span><span class="symbol">&lt;</span><span class="normal">info</span><span class="symbol">&gt;</span>
 247 <span class="normal">      </span><span class="symbol">&lt;</span><span class="normal">metadata owner</span><span class="symbol">=</span><span class="string">"http://freedesktop.org"</span><span class="symbol">&gt;</span>
 248 <span class="normal">        </span><span class="symbol">&lt;</span><span class="normal">mime</span><span class="symbol">:</span><span class="normal">mime</span><span class="symbol">-</span><span class="normal">type</span><span class="symbol">&gt;</span><span class="normal">text</span><span class="symbol">/</span><span class="normal">xml</span><span class="symbol">&lt;/</span><span class="normal">mime</span><span class="symbol">:</span><span class="normal">mime</span><span class="symbol">-</span><span class="normal">type</span><span class="symbol">&gt;</span>
 249 <span class="normal">   </span><span class="symbol">&lt;</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">applications</span><span class="symbol">&gt;</span>
 250 <span class="normal">          </span><span class="symbol">&lt;</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">application name</span><span class="symbol">=</span><span class="string">"GEdit"</span><span class="normal"> count</span><span class="symbol">=</span><span class="string">"2"</span><span class="normal"> exec</span><span class="symbol">=</span><span class="string">"gedit %u"</span><span class="normal"> timestamp</span><span class="symbol">=</span><span class="string">"1115726763"</span><span class="symbol">/&gt;</span>
 251 <span class="normal">          </span><span class="symbol">&lt;</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">application name</span><span class="symbol">=</span><span class="string">"GViM"</span><span class="normal"> count</span><span class="symbol">=</span><span class="string">"7"</span><span class="normal"> exec</span><span class="symbol">=</span><span class="string">"gvim %f"</span><span class="normal"> timestamp</span><span class="symbol">=</span><span class="string">"1115726812"</span><span class="symbol">/&gt;</span>
 252 <span class="normal">   </span><span class="symbol">&lt;/</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">applications</span><span class="symbol">&gt;</span>
 253 <span class="normal">   </span><span class="symbol">&lt;</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">groups</span><span class="symbol">&gt;</span>
 254 <span class="normal">     </span><span class="symbol">&lt;</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">group</span><span class="symbol">&gt;</span><span class="normal">Editors</span><span class="symbol">&lt;/</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">group</span><span class="symbol">&gt;</span>
 255 <span class="normal">   </span><span class="symbol">&lt;/</span><span class="normal">bookmark</span><span class="symbol">:</span><span class="normal">groups</span><span class="symbol">&gt;</span>
 256 <span class="normal">      </span><span class="symbol">&lt;/</span><span class="normal">metadata</span><span class="symbol">&gt;</span>
 257 <span class="normal">    </span><span class="symbol">&lt;/</span><span class="normal">info</span><span class="symbol">&gt;</span>
 258 <span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">bookmark</span><span class="symbol">&gt;</span>
 259 <span class="symbol">&lt;/</span><span class="normal">xbel</span><span class="symbol">&gt;</span></pre></td>
 260       </tr>
 261     </tbody>
 262   </table>
 263 </div>
 264
 265 <p>
 266 A bookmark file might contain more than one bookmark; each bookmark is accessed
 267 through its URI.
 268 </p>
 269 <p>
 270 The important caveat of bookmark files is that when you add a new bookmark you
 271 must also add the application that is registering it, using
 272 <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-add-application" title="g_bookmark_file_add_application ()"><code class="function">g_bookmark_file_add_application()</code></a> or <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-app-info" title="g_bookmark_file_set_app_info ()"><code class="function">g_bookmark_file_set_app_info()</code></a>. If a
 273 bookmark has no applications then it won't be dumped when creating the
 274 on disk representation, using <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-to-data" title="g_bookmark_file_to_data ()"><code class="function">g_bookmark_file_to_data()</code></a> or
 275 <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-to-file" title="g_bookmark_file_to_file ()"><code class="function">g_bookmark_file_to_file()</code></a>.
 276 </p>
 277 <p>
 278 The <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> parser was added in GLib 2.12.
 279 </p>
 280 </div>
 281 <div class="refsect1" title="Details">
 282 <a name="glib-Bookmark-file-parser.details"></a><h2>Details</h2>
 283 <div class="refsect2" title="GBookmarkFile">
 284 <a name="GBookmarkFile"></a><h3>GBookmarkFile</h3>
 285 <pre class="programlisting">typedef struct _GBookmarkFile GBookmarkFile;</pre>
 286 <p>
 287 The <span class="structname">GBookmarkFile</span> struct contains only private data
 288 and should not be used directly.
 289 </p>
 290 </div>
 291 <hr>
 292 <div class="refsect2" title="G_BOOKMARK_FILE_ERROR">
 293 <a name="G-BOOKMARK-FILE-ERROR:CAPS"></a><h3>G_BOOKMARK_FILE_ERROR</h3>
 294 <pre class="programlisting">#define             G_BOOKMARK_FILE_ERROR</pre>
 295 <p>
 296 Error domain for bookmark file parsing. Errors in this domain will be
 297 from the <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFileError" title="enum GBookmarkFileError"><span class="type">GBookmarkFileError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> for informations
 298 on error domains.
 299 </p>
 300 </div>
 301 <hr>
 302 <div class="refsect2" title="enum GBookmarkFileError">
 303 <a name="GBookmarkFileError"></a><h3>enum GBookmarkFileError</h3>
 304 <pre class="programlisting">typedef enum
 305 {
 306   G_BOOKMARK_FILE_ERROR_INVALID_URI,
 307   G_BOOKMARK_FILE_ERROR_INVALID_VALUE,
 308   G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED,
 309   G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND,
 310   G_BOOKMARK_FILE_ERROR_READ,
 311   G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING,
 312   G_BOOKMARK_FILE_ERROR_WRITE,
 313   G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND
 314 } GBookmarkFileError;
 315 </pre>
 316 <p>
 317 Error codes returned by bookmark file parsing.
 318 </p>
 319 <div class="variablelist"><table border="0">
 320 <col align="left" valign="top">
 321 <tbody>
 322 <tr>
 323 <td><p><a name="G-BOOKMARK-FILE-ERROR-INVALID-URI:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_INVALID_URI</code></span></p></td>
 324 <td>URI was ill-formed
 325 </td>
 326 </tr>
 327 <tr>
 328 <td><p><a name="G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_INVALID_VALUE</code></span></p></td>
 329 <td>a requested field was not found
 330 </td>
 331 </tr>
 332 <tr>
 333 <td><p><a name="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</code></span></p></td>
 334 <td>a requested application did not
 335 register a bookmark
 336 </td>
 337 </tr>
 338 <tr>
 339 <td><p><a name="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</code></span></p></td>
 340 <td>a requested URI was not found
 341 </td>
 342 </tr>
 343 <tr>
 344 <td><p><a name="G-BOOKMARK-FILE-ERROR-READ:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_READ</code></span></p></td>
 345 <td>document was ill formed
 346 </td>
 347 </tr>
 348 <tr>
 349 <td><p><a name="G-BOOKMARK-FILE-ERROR-UNKNOWN-ENCODING:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING</code></span></p></td>
 350 <td>the text being parsed was in an
 351 unknown encoding
 352 </td>
 353 </tr>
 354 <tr>
 355 <td><p><a name="G-BOOKMARK-FILE-ERROR-WRITE:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_WRITE</code></span></p></td>
 356 <td>an error occurred while writing
 357 </td>
 358 </tr>
 359 <tr>
 360 <td><p><a name="G-BOOKMARK-FILE-ERROR-FILE-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND</code></span></p></td>
 361 <td>requested file was not found
 362 </td>
 363 </tr>
 364 </tbody>
 365 </table></div>
 366 </div>
 367 <hr>
 368 <div class="refsect2" title="g_bookmark_file_new ()">
 369 <a name="g-bookmark-file-new"></a><h3>g_bookmark_file_new ()</h3>
 370 <pre class="programlisting"><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="returnvalue">GBookmarkFile</span></a> *     g_bookmark_file_new                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 371 <p>
 372 Creates a new empty <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> object.
 373 </p>
 374 <p>
 375 Use <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-load-from-file" title="g_bookmark_file_load_from_file ()"><code class="function">g_bookmark_file_load_from_file()</code></a>, <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-load-from-data" title="g_bookmark_file_load_from_data ()"><code class="function">g_bookmark_file_load_from_data()</code></a>
 376 or <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-load-from-data-dirs" title="g_bookmark_file_load_from_data_dirs ()"><code class="function">g_bookmark_file_load_from_data_dirs()</code></a> to read an existing bookmark
 377 file.
 378 </p>
 379 <div class="variablelist"><table border="0">
 380 <col align="left" valign="top">
 381 <tbody><tr>
 382 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 383 <td> an empty <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 384
 385 </td>
 386 </tr></tbody>
 387 </table></div>
 388 <p class="since">Since 2.12</p>
 389 </div>
 390 <hr>
 391 <div class="refsect2" title="g_bookmark_file_free ()">
 392 <a name="g-bookmark-file-free"></a><h3>g_bookmark_file_free ()</h3>
 393 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_free                (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>);</pre>
 394 <p>
 395 Frees a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>.
 396 </p>
 397 <div class="variablelist"><table border="0">
 398 <col align="left" valign="top">
 399 <tbody><tr>
 400 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 401 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 402 </td>
 403 </tr></tbody>
 404 </table></div>
 405 <p class="since">Since 2.12</p>
 406 </div>
 407 <hr>
 408 <div class="refsect2" title="g_bookmark_file_load_from_file ()">
 409 <a name="g-bookmark-file-load-from-file"></a><h3>g_bookmark_file_load_from_file ()</h3>
 410 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_load_from_file      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 411                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>,
 412                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 413 <p>
 414 Loads a desktop bookmark file into an empty <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> structure.
 415 If the file could not be loaded then <em class="parameter"><code>error</code></em> is set to either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a>
 416 or <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFileError" title="enum GBookmarkFileError"><span class="type">GBookmarkFileError</span></a>.
 417 </p>
 418 <div class="variablelist"><table border="0">
 419 <col align="left" valign="top">
 420 <tbody>
 421 <tr>
 422 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 423 <td>an empty <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> struct
 424 </td>
 425 </tr>
 426 <tr>
 427 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
 428 <td>the path of a filename to load, in the GLib file name encoding
 429 </td>
 430 </tr>
 431 <tr>
 432 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 433 <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>
 434 </td>
 435 </tr>
 436 <tr>
 437 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 438 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a desktop bookmark file could be loaded
 439
 440 </td>
 441 </tr>
 442 </tbody>
 443 </table></div>
 444 <p class="since">Since 2.12</p>
 445 </div>
 446 <hr>
 447 <div class="refsect2" title="g_bookmark_file_load_from_data ()">
 448 <a name="g-bookmark-file-load-from-data"></a><h3>g_bookmark_file_load_from_data ()</h3>
 449 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_load_from_data      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 450                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *data</code></em>,
 451                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>,
 452                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 453 <p>
 454 Loads a bookmark file from memory into an empty <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 455 structure.  If the object cannot be created then <em class="parameter"><code>error</code></em> is set to a
 456 <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFileError" title="enum GBookmarkFileError"><span class="type">GBookmarkFileError</span></a>.
 457 </p>
 458 <div class="variablelist"><table border="0">
 459 <col align="left" valign="top">
 460 <tbody>
 461 <tr>
 462 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 463 <td>an empty <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> struct
 464 </td>
 465 </tr>
 466 <tr>
 467 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 468 <td>desktop bookmarks loaded in memory
 469 </td>
 470 </tr>
 471 <tr>
 472 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 473 <td>the length of <em class="parameter"><code>data</code></em> in bytes
 474 </td>
 475 </tr>
 476 <tr>
 477 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 478 <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>
 479 </td>
 480 </tr>
 481 <tr>
 482 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 483 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a desktop bookmark could be loaded.
 484
 485 </td>
 486 </tr>
 487 </tbody>
 488 </table></div>
 489 <p class="since">Since 2.12</p>
 490 </div>
 491 <hr>
 492 <div class="refsect2" title="g_bookmark_file_load_from_data_dirs ()">
 493 <a name="g-bookmark-file-load-from-data-dirs"></a><h3>g_bookmark_file_load_from_data_dirs ()</h3>
 494 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_load_from_data_dirs (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 495                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *file</code></em>,
 496                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **full_path</code></em>,
 497                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 498 <p>
 499 This function looks for a desktop bookmark file named <em class="parameter"><code>file</code></em> in the
 500 paths 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>,
 501 loads the file into <em class="parameter"><code>bookmark</code></em> and returns the file's full path in
 502 <em class="parameter"><code>full_path</code></em>.  If the file could not be loaded then an <code class="literal">error</code> is
 503 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-Bookmark-file-parser.html#GBookmarkFileError" title="enum GBookmarkFileError"><span class="type">GBookmarkFileError</span></a>.
 504 </p>
 505 <div class="variablelist"><table border="0">
 506 <col align="left" valign="top">
 507 <tbody>
 508 <tr>
 509 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 510 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 511 </td>
 512 </tr>
 513 <tr>
 514 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
 515 <td>a relative path to a filename to open and parse
 516 </td>
 517 </tr>
 518 <tr>
 519 <td><p><span class="term"><em class="parameter"><code>full_path</code></em> :</span></p></td>
 520 <td>return location for a string containing the full path
 521   of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 522 </td>
 523 </tr>
 524 <tr>
 525 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 526 <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>
 527 </td>
 528 </tr>
 529 <tr>
 530 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 531 <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
 532
 533 </td>
 534 </tr>
 535 </tbody>
 536 </table></div>
 537 <p class="since">Since 2.12</p>
 538 </div>
 539 <hr>
 540 <div class="refsect2" title="g_bookmark_file_to_data ()">
 541 <a name="g-bookmark-file-to-data"></a><h3>g_bookmark_file_to_data ()</h3>
 542 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_bookmark_file_to_data             (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 543                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
 544                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 545 <p>
 546 This function outputs <em class="parameter"><code>bookmark</code></em> as a string.
 547 </p>
 548 <div class="variablelist"><table border="0">
 549 <col align="left" valign="top">
 550 <tbody>
 551 <tr>
 552 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 553 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 554 </td>
 555 </tr>
 556 <tr>
 557 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 558 <td>return location for the length of the returned string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 559 </td>
 560 </tr>
 561 <tr>
 562 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 563 <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>
 564 </td>
 565 </tr>
 566 <tr>
 567 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 568 <td> a newly allocated string holding
 569   the contents of the <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 570
 571 </td>
 572 </tr>
 573 </tbody>
 574 </table></div>
 575 <p class="since">Since 2.12</p>
 576 </div>
 577 <hr>
 578 <div class="refsect2" title="g_bookmark_file_to_file ()">
 579 <a name="g-bookmark-file-to-file"></a><h3>g_bookmark_file_to_file ()</h3>
 580 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_to_file             (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 581                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *filename</code></em>,
 582                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 583 <p>
 584 This function outputs <em class="parameter"><code>bookmark</code></em> into a file.  The write process is
 585 guaranteed to be atomic by using <a class="link" href="glib-File-Utilities.html#g-file-set-contents" title="g_file_set_contents ()"><code class="function">g_file_set_contents()</code></a> internally.
 586 </p>
 587 <div class="variablelist"><table border="0">
 588 <col align="left" valign="top">
 589 <tbody>
 590 <tr>
 591 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 592 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 593 </td>
 594 </tr>
 595 <tr>
 596 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
 597 <td>path of the output file
 598 </td>
 599 </tr>
 600 <tr>
 601 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 602 <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>
 603 </td>
 604 </tr>
 605 <tr>
 606 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 607 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the file was successfully written.
 608
 609 </td>
 610 </tr>
 611 </tbody>
 612 </table></div>
 613 <p class="since">Since 2.12</p>
 614 </div>
 615 <hr>
 616 <div class="refsect2" title="g_bookmark_file_has_item ()">
 617 <a name="g-bookmark-file-has-item"></a><h3>g_bookmark_file_has_item ()</h3>
 618 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_has_item            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 619                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>);</pre>
 620 <p>
 621 Looks whether the desktop bookmark has an item with its URI set to <em class="parameter"><code>uri</code></em>.
 622 </p>
 623 <div class="variablelist"><table border="0">
 624 <col align="left" valign="top">
 625 <tbody>
 626 <tr>
 627 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 628 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 629 </td>
 630 </tr>
 631 <tr>
 632 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 633 <td>a valid URI
 634 </td>
 635 </tr>
 636 <tr>
 637 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 638 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>uri</code></em> is inside <em class="parameter"><code>bookmark</code></em>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise
 639
 640 </td>
 641 </tr>
 642 </tbody>
 643 </table></div>
 644 <p class="since">Since 2.12</p>
 645 </div>
 646 <hr>
 647 <div class="refsect2" title="g_bookmark_file_has_group ()">
 648 <a name="g-bookmark-file-has-group"></a><h3>g_bookmark_file_has_group ()</h3>
 649 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_has_group           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 650                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 651                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group</code></em>,
 652                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 653 <p>
 654 Checks whether <em class="parameter"><code>group</code></em> appears in the list of groups to which
 655 the bookmark for <em class="parameter"><code>uri</code></em> belongs to.
 656 </p>
 657 <p>
 658 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
 659 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
 660 </p>
 661 <div class="variablelist"><table border="0">
 662 <col align="left" valign="top">
 663 <tbody>
 664 <tr>
 665 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 666 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 667 </td>
 668 </tr>
 669 <tr>
 670 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 671 <td>a valid URI
 672 </td>
 673 </tr>
 674 <tr>
 675 <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
 676 <td>the group name to be searched
 677 </td>
 678 </tr>
 679 <tr>
 680 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 681 <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>
 682 </td>
 683 </tr>
 684 <tr>
 685 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 686 <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</code></em> was found.
 687
 688 </td>
 689 </tr>
 690 </tbody>
 691 </table></div>
 692 <p class="since">Since 2.12</p>
 693 </div>
 694 <hr>
 695 <div class="refsect2" title="g_bookmark_file_has_application ()">
 696 <a name="g-bookmark-file-has-application"></a><h3>g_bookmark_file_has_application ()</h3>
 697 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_has_application     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 698                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 699                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
 700                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 701 <p>
 702 Checks whether the bookmark for <em class="parameter"><code>uri</code></em> inside <em class="parameter"><code>bookmark</code></em> has been
 703 registered by application <em class="parameter"><code>name</code></em>.
 704 </p>
 705 <p>
 706 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
 707 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
 708 </p>
 709 <div class="variablelist"><table border="0">
 710 <col align="left" valign="top">
 711 <tbody>
 712 <tr>
 713 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 714 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 715 </td>
 716 </tr>
 717 <tr>
 718 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 719 <td>a valid URI
 720 </td>
 721 </tr>
 722 <tr>
 723 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 724 <td>the name of the application
 725 </td>
 726 </tr>
 727 <tr>
 728 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 729 <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>
 730 </td>
 731 </tr>
 732 <tr>
 733 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 734 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the application <em class="parameter"><code>name</code></em> was found
 735
 736 </td>
 737 </tr>
 738 </tbody>
 739 </table></div>
 740 <p class="since">Since 2.12</p>
 741 </div>
 742 <hr>
 743 <div class="refsect2" title="g_bookmark_file_get_size ()">
 744 <a name="g-bookmark-file-get-size"></a><h3>g_bookmark_file_get_size ()</h3>
 745 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_bookmark_file_get_size            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>);</pre>
 746 <p>
 747 Gets the number of bookmarks inside <em class="parameter"><code>bookmark</code></em>.
 748 </p>
 749 <div class="variablelist"><table border="0">
 750 <col align="left" valign="top">
 751 <tbody>
 752 <tr>
 753 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 754 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 755 </td>
 756 </tr>
 757 <tr>
 758 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 759 <td> the number of bookmarks
 760
 761 </td>
 762 </tr>
 763 </tbody>
 764 </table></div>
 765 <p class="since">Since 2.12</p>
 766 </div>
 767 <hr>
 768 <div class="refsect2" title="g_bookmark_file_get_uris ()">
 769 <a name="g-bookmark-file-get-uris"></a><h3>g_bookmark_file_get_uris ()</h3>
 770 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_bookmark_file_get_uris            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 771                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
 772 <p>
 773 Returns all URIs of the bookmarks in the bookmark file <em class="parameter"><code>bookmark</code></em>.
 774 The array of returned URIs 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
 775 optionally be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
 776 </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>bookmark</code></em> :</span></p></td>
 782 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 783 </td>
 784 </tr>
 785 <tr>
 786 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 787 <td>return location for the number of returned URIs, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 788 </td>
 789 </tr>
 790 <tr>
 791 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 792 <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.
 793   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.
 794
 795 </td>
 796 </tr>
 797 </tbody>
 798 </table></div>
 799 <p class="since">Since 2.12</p>
 800 </div>
 801 <hr>
 802 <div class="refsect2" title="g_bookmark_file_get_title ()">
 803 <a name="g-bookmark-file-get-title"></a><h3>g_bookmark_file_get_title ()</h3>
 804 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_bookmark_file_get_title           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 805                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 806                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 807 <p>
 808 Returns the title of the bookmark for <em class="parameter"><code>uri</code></em>.
 809 </p>
 810 <p>
 811 If <em class="parameter"><code>uri</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the title of <em class="parameter"><code>bookmark</code></em> is returned.
 812 </p>
 813 <p>
 814 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
 815 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
 816 </p>
 817 <div class="variablelist"><table border="0">
 818 <col align="left" valign="top">
 819 <tbody>
 820 <tr>
 821 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 822 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 823 </td>
 824 </tr>
 825 <tr>
 826 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 827 <td>a valid URI or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
 828 </td>
 829 </tr>
 830 <tr>
 831 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 832 <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>
 833 </td>
 834 </tr>
 835 <tr>
 836 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 837 <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
 838   URI cannot be found.
 839
 840 </td>
 841 </tr>
 842 </tbody>
 843 </table></div>
 844 <p class="since">Since 2.12</p>
 845 </div>
 846 <hr>
 847 <div class="refsect2" title="g_bookmark_file_get_description ()">
 848 <a name="g-bookmark-file-get-description"></a><h3>g_bookmark_file_get_description ()</h3>
 849 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_bookmark_file_get_description     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 850                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 851                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 852 <p>
 853 Retrieves the description of the bookmark for <em class="parameter"><code>uri</code></em>.
 854 </p>
 855 <p>
 856 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
 857 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
 858 </p>
 859 <div class="variablelist"><table border="0">
 860 <col align="left" valign="top">
 861 <tbody>
 862 <tr>
 863 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 864 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 865 </td>
 866 </tr>
 867 <tr>
 868 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 869 <td>a valid URI
 870 </td>
 871 </tr>
 872 <tr>
 873 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 874 <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>
 875 </td>
 876 </tr>
 877 <tr>
 878 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 879 <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
 880   URI cannot be found.
 881
 882 </td>
 883 </tr>
 884 </tbody>
 885 </table></div>
 886 <p class="since">Since 2.12</p>
 887 </div>
 888 <hr>
 889 <div class="refsect2" title="g_bookmark_file_get_mime_type ()">
 890 <a name="g-bookmark-file-get-mime-type"></a><h3>g_bookmark_file_get_mime_type ()</h3>
 891 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_bookmark_file_get_mime_type       (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 892                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 893                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 894 <p>
 895 Retrieves the MIME type of the resource pointed by <em class="parameter"><code>uri</code></em>.
 896 </p>
 897 <p>
 898 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
 899 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.  In the
 900 event that the MIME type cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
 901 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_INVALID_VALUE</span></a>.
 902 </p>
 903 <div class="variablelist"><table border="0">
 904 <col align="left" valign="top">
 905 <tbody>
 906 <tr>
 907 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 908 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 909 </td>
 910 </tr>
 911 <tr>
 912 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 913 <td>a valid URI
 914 </td>
 915 </tr>
 916 <tr>
 917 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 918 <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>
 919 </td>
 920 </tr>
 921 <tr>
 922 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 923 <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
 924   URI cannot be found.
 925
 926 </td>
 927 </tr>
 928 </tbody>
 929 </table></div>
 930 <p class="since">Since 2.12</p>
 931 </div>
 932 <hr>
 933 <div class="refsect2" title="g_bookmark_file_get_is_private ()">
 934 <a name="g-bookmark-file-get-is-private"></a><h3>g_bookmark_file_get_is_private ()</h3>
 935 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_get_is_private      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 936                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 937                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 938 <p>
 939 Gets whether the private flag of the bookmark for <em class="parameter"><code>uri</code></em> is set.
 940 </p>
 941 <p>
 942 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
 943 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.  In the
 944 event that the private flag cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
 945 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_INVALID_VALUE</span></a>.
 946 </p>
 947 <div class="variablelist"><table border="0">
 948 <col align="left" valign="top">
 949 <tbody>
 950 <tr>
 951 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 952 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 953 </td>
 954 </tr>
 955 <tr>
 956 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 957 <td>a valid URI
 958 </td>
 959 </tr>
 960 <tr>
 961 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 962 <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>
 963 </td>
 964 </tr>
 965 <tr>
 966 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 967 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the private flag is set, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise.
 968
 969 </td>
 970 </tr>
 971 </tbody>
 972 </table></div>
 973 <p class="since">Since 2.12</p>
 974 </div>
 975 <hr>
 976 <div class="refsect2" title="g_bookmark_file_get_icon ()">
 977 <a name="g-bookmark-file-get-icon"></a><h3>g_bookmark_file_get_icon ()</h3>
 978 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_get_icon            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
 979                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
 980                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **href</code></em>,
 981                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **mime_type</code></em>,
 982                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 983 <p>
 984 Gets the icon of the bookmark for <em class="parameter"><code>uri</code></em>.
 985 </p>
 986 <p>
 987 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
 988 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
 989 </p>
 990 <div class="variablelist"><table border="0">
 991 <col align="left" valign="top">
 992 <tbody>
 993 <tr>
 994 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
 995 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
 996 </td>
 997 </tr>
 998 <tr>
 999 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1000 <td>a valid URI
1001 </td>
1002 </tr>
1003 <tr>
1004 <td><p><span class="term"><em class="parameter"><code>href</code></em> :</span></p></td>
1005 <td>return location for the icon's location or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1006 </td>
1007 </tr>
1008 <tr>
1009 <td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
1010 <td>return location for the icon's MIME type or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1011 </td>
1012 </tr>
1013 <tr>
1014 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1015 <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>
1016 </td>
1017 </tr>
1018 <tr>
1019 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1020 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the icon for the bookmark for the URI was found.
1021   You should free the returned strings.
1022
1023 </td>
1024 </tr>
1025 </tbody>
1026 </table></div>
1027 <p class="since">Since 2.12</p>
1028 </div>
1029 <hr>
1030 <div class="refsect2" title="g_bookmark_file_get_added ()">
1031 <a name="g-bookmark-file-get-added"></a><h3>g_bookmark_file_get_added ()</h3>
1032 <pre class="programlisting"><span class="returnvalue">time_t</span>              g_bookmark_file_get_added           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1033                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1034                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1035 <p>
1036 Gets the time the bookmark for <em class="parameter"><code>uri</code></em> was added to <em class="parameter"><code>bookmark</code></em>
1037 </p>
1038 <p>
1039 In the event the URI cannot be found, -1 is returned and
1040 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1041 </p>
1042 <div class="variablelist"><table border="0">
1043 <col align="left" valign="top">
1044 <tbody>
1045 <tr>
1046 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1047 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1048 </td>
1049 </tr>
1050 <tr>
1051 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1052 <td>a valid URI
1053 </td>
1054 </tr>
1055 <tr>
1056 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1057 <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>
1058 </td>
1059 </tr>
1060 <tr>
1061 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1062 <td> a timestamp
1063
1064 </td>
1065 </tr>
1066 </tbody>
1067 </table></div>
1068 <p class="since">Since 2.12</p>
1069 </div>
1070 <hr>
1071 <div class="refsect2" title="g_bookmark_file_get_modified ()">
1072 <a name="g-bookmark-file-get-modified"></a><h3>g_bookmark_file_get_modified ()</h3>
1073 <pre class="programlisting"><span class="returnvalue">time_t</span>              g_bookmark_file_get_modified        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1074                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1075                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1076 <p>
1077 Gets the time when the bookmark for <em class="parameter"><code>uri</code></em> was last modified.
1078 </p>
1079 <p>
1080 In the event the URI cannot be found, -1 is returned and
1081 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1082 </p>
1083 <div class="variablelist"><table border="0">
1084 <col align="left" valign="top">
1085 <tbody>
1086 <tr>
1087 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1088 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1089 </td>
1090 </tr>
1091 <tr>
1092 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1093 <td>a valid URI
1094 </td>
1095 </tr>
1096 <tr>
1097 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1098 <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>
1099 </td>
1100 </tr>
1101 <tr>
1102 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1103 <td> a timestamp
1104
1105 </td>
1106 </tr>
1107 </tbody>
1108 </table></div>
1109 <p class="since">Since 2.12</p>
1110 </div>
1111 <hr>
1112 <div class="refsect2" title="g_bookmark_file_get_visited ()">
1113 <a name="g-bookmark-file-get-visited"></a><h3>g_bookmark_file_get_visited ()</h3>
1114 <pre class="programlisting"><span class="returnvalue">time_t</span>              g_bookmark_file_get_visited         (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1115                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1116                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1117 <p>
1118 Gets the time the bookmark for <em class="parameter"><code>uri</code></em> was last visited.
1119 </p>
1120 <p>
1121 In the event the URI cannot be found, -1 is returned and
1122 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1123 </p>
1124 <div class="variablelist"><table border="0">
1125 <col align="left" valign="top">
1126 <tbody>
1127 <tr>
1128 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1129 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1130 </td>
1131 </tr>
1132 <tr>
1133 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1134 <td>a valid URI
1135 </td>
1136 </tr>
1137 <tr>
1138 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1139 <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>
1140 </td>
1141 </tr>
1142 <tr>
1143 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1144 <td> a timestamp.
1145
1146 </td>
1147 </tr>
1148 </tbody>
1149 </table></div>
1150 <p class="since">Since 2.12</p>
1151 </div>
1152 <hr>
1153 <div class="refsect2" title="g_bookmark_file_get_groups ()">
1154 <a name="g-bookmark-file-get-groups"></a><h3>g_bookmark_file_get_groups ()</h3>
1155 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_bookmark_file_get_groups          (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1156                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1157                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1158                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1159 <p>
1160 Retrieves the list of group names of the bookmark for <em class="parameter"><code>uri</code></em>.
1161 </p>
1162 <p>
1163 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
1164 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1165 </p>
1166 <p>
1167 The 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
1168 be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
1169 </p>
1170 <div class="variablelist"><table border="0">
1171 <col align="left" valign="top">
1172 <tbody>
1173 <tr>
1174 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1175 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1176 </td>
1177 </tr>
1178 <tr>
1179 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1180 <td>a valid URI
1181 </td>
1182 </tr>
1183 <tr>
1184 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1185 <td>return location for the length of the returned string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1186 </td>
1187 </tr>
1188 <tr>
1189 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1190 <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>
1191 </td>
1192 </tr>
1193 <tr>
1194 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1195 <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 group names.
1196   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.
1197
1198 </td>
1199 </tr>
1200 </tbody>
1201 </table></div>
1202 <p class="since">Since 2.12</p>
1203 </div>
1204 <hr>
1205 <div class="refsect2" title="g_bookmark_file_get_applications ()">
1206 <a name="g-bookmark-file-get-applications"></a><h3>g_bookmark_file_get_applications ()</h3>
1207 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_bookmark_file_get_applications    (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1208                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1209                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>,
1210                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1211 <p>
1212 Retrieves the names of the applications that have registered the
1213 bookmark for <em class="parameter"><code>uri</code></em>.
1214 </p>
1215 <p>
1216 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and
1217 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1218 </p>
1219 <div class="variablelist"><table border="0">
1220 <col align="left" valign="top">
1221 <tbody>
1222 <tr>
1223 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1224 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1225 </td>
1226 </tr>
1227 <tr>
1228 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1229 <td>a valid URI
1230 </td>
1231 </tr>
1232 <tr>
1233 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1234 <td>return location of the length of the returned list, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1235 </td>
1236 </tr>
1237 <tr>
1238 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1239 <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>
1240 </td>
1241 </tr>
1242 <tr>
1243 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1244 <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.
1245   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.
1246
1247 </td>
1248 </tr>
1249 </tbody>
1250 </table></div>
1251 <p class="since">Since 2.12</p>
1252 </div>
1253 <hr>
1254 <div class="refsect2" title="g_bookmark_file_get_app_info ()">
1255 <a name="g-bookmark-file-get-app-info"></a><h3>g_bookmark_file_get_app_info ()</h3>
1256 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_get_app_info        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1257                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1258                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
1259                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **exec</code></em>,
1260                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> *count</code></em>,
1261                                                          <em class="parameter"><code><span class="type">time_t</span> *stamp</code></em>,
1262                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1263 <p>
1264 Gets the registration informations of <em class="parameter"><code>app_name</code></em> for the bookmark for
1265 <em class="parameter"><code>uri</code></em>.  See <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-app-info" title="g_bookmark_file_set_app_info ()"><code class="function">g_bookmark_file_set_app_info()</code></a> for more informations about
1266 the returned data.
1267 </p>
1268 <p>
1269 The string returned in <em class="parameter"><code>app_exec</code></em> must be freed.
1270 </p>
1271 <p>
1272 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
1273 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.  In the
1274 event that no application with name <em class="parameter"><code>app_name</code></em> has registered a bookmark
1275 for <em class="parameter"><code>uri</code></em>,  <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and error is set to
1276 <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</span></a>. In the event that unquoting
1277 the command line fails, an error of the <a class="link" href="glib-Shell-related-Utilities.html#G-SHELL-ERROR:CAPS" title="G_SHELL_ERROR"><span class="type">G_SHELL_ERROR</span></a> domain is
1278 set and <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned.
1279 </p>
1280 <div class="variablelist"><table border="0">
1281 <col align="left" valign="top">
1282 <tbody>
1283 <tr>
1284 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1285 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1286 </td>
1287 </tr>
1288 <tr>
1289 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1290 <td>a valid URI
1291 </td>
1292 </tr>
1293 <tr>
1294 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1295 <td>an application's name
1296 </td>
1297 </tr>
1298 <tr>
1299 <td><p><span class="term"><em class="parameter"><code>exec</code></em> :</span></p></td>
1300 <td>location for the command line of the application, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1301 </td>
1302 </tr>
1303 <tr>
1304 <td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
1305 <td>return location for the registration count, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1306 </td>
1307 </tr>
1308 <tr>
1309 <td><p><span class="term"><em class="parameter"><code>stamp</code></em> :</span></p></td>
1310 <td>return location for the last registration time, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1311 </td>
1312 </tr>
1313 <tr>
1314 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1315 <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>
1316 </td>
1317 </tr>
1318 <tr>
1319 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1320 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> on success.
1321
1322 </td>
1323 </tr>
1324 </tbody>
1325 </table></div>
1326 <p class="since">Since 2.12</p>
1327 </div>
1328 <hr>
1329 <div class="refsect2" title="g_bookmark_file_set_title ()">
1330 <a name="g-bookmark-file-set-title"></a><h3>g_bookmark_file_set_title ()</h3>
1331 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_title           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1332                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1333                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
1334 <p>
1335 Sets <em class="parameter"><code>title</code></em> as the title of the bookmark for <em class="parameter"><code>uri</code></em> inside the
1336 bookmark file <em class="parameter"><code>bookmark</code></em>.
1337 </p>
1338 <p>
1339 If <em class="parameter"><code>uri</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the title of <em class="parameter"><code>bookmark</code></em> is set.
1340 </p>
1341 <p>
1342 If a bookmark for <em class="parameter"><code>uri</code></em> cannot be found then it is created.
1343 </p>
1344 <div class="variablelist"><table border="0">
1345 <col align="left" valign="top">
1346 <tbody>
1347 <tr>
1348 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1349 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1350 </td>
1351 </tr>
1352 <tr>
1353 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1354 <td>a valid URI or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1355 </td>
1356 </tr>
1357 <tr>
1358 <td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
1359 <td>a UTF-8 encoded string
1360 </td>
1361 </tr>
1362 </tbody>
1363 </table></div>
1364 <p class="since">Since 2.12</p>
1365 </div>
1366 <hr>
1367 <div class="refsect2" title="g_bookmark_file_set_description ()">
1368 <a name="g-bookmark-file-set-description"></a><h3>g_bookmark_file_set_description ()</h3>
1369 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_description     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1370                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1371                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *description</code></em>);</pre>
1372 <p>
1373 Sets <em class="parameter"><code>description</code></em> as the description of the bookmark for <em class="parameter"><code>uri</code></em>.
1374 </p>
1375 <p>
1376 If <em class="parameter"><code>uri</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the description of <em class="parameter"><code>bookmark</code></em> is set.
1377 </p>
1378 <p>
1379 If a bookmark for <em class="parameter"><code>uri</code></em> cannot be found then it is created.
1380 </p>
1381 <div class="variablelist"><table border="0">
1382 <col align="left" valign="top">
1383 <tbody>
1384 <tr>
1385 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1386 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1387 </td>
1388 </tr>
1389 <tr>
1390 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1391 <td>a valid URI or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1392 </td>
1393 </tr>
1394 <tr>
1395 <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
1396 <td>a string
1397 </td>
1398 </tr>
1399 </tbody>
1400 </table></div>
1401 <p class="since">Since 2.12</p>
1402 </div>
1403 <hr>
1404 <div class="refsect2" title="g_bookmark_file_set_mime_type ()">
1405 <a name="g-bookmark-file-set-mime-type"></a><h3>g_bookmark_file_set_mime_type ()</h3>
1406 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_mime_type       (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1407                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1408                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *mime_type</code></em>);</pre>
1409 <p>
1410 Sets <em class="parameter"><code>mime_type</code></em> as the MIME type of the bookmark for <em class="parameter"><code>uri</code></em>.
1411 </p>
1412 <p>
1413 If a bookmark for <em class="parameter"><code>uri</code></em> cannot be found then it is created.
1414 </p>
1415 <div class="variablelist"><table border="0">
1416 <col align="left" valign="top">
1417 <tbody>
1418 <tr>
1419 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1420 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1421 </td>
1422 </tr>
1423 <tr>
1424 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1425 <td>a valid URI
1426 </td>
1427 </tr>
1428 <tr>
1429 <td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
1430 <td>a MIME type
1431 </td>
1432 </tr>
1433 </tbody>
1434 </table></div>
1435 <p class="since">Since 2.12</p>
1436 </div>
1437 <hr>
1438 <div class="refsect2" title="g_bookmark_file_set_is_private ()">
1439 <a name="g-bookmark-file-set-is-private"></a><h3>g_bookmark_file_set_is_private ()</h3>
1440 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_is_private      (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1441                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1442                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> is_private</code></em>);</pre>
1443 <p>
1444 Sets the private flag of the bookmark for <em class="parameter"><code>uri</code></em>.
1445 </p>
1446 <p>
1447 If a bookmark for <em class="parameter"><code>uri</code></em> cannot be found then it is created.
1448 </p>
1449 <div class="variablelist"><table border="0">
1450 <col align="left" valign="top">
1451 <tbody>
1452 <tr>
1453 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1454 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1455 </td>
1456 </tr>
1457 <tr>
1458 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1459 <td>a valid URI
1460 </td>
1461 </tr>
1462 <tr>
1463 <td><p><span class="term"><em class="parameter"><code>is_private</code></em> :</span></p></td>
1464 <td>
1465 <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the bookmark should be marked as private
1466 </td>
1467 </tr>
1468 </tbody>
1469 </table></div>
1470 <p class="since">Since 2.12</p>
1471 </div>
1472 <hr>
1473 <div class="refsect2" title="g_bookmark_file_set_icon ()">
1474 <a name="g-bookmark-file-set-icon"></a><h3>g_bookmark_file_set_icon ()</h3>
1475 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_icon            (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1476                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1477                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *href</code></em>,
1478                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *mime_type</code></em>);</pre>
1479 <p>
1480 Sets the icon for the bookmark for <em class="parameter"><code>uri</code></em>. If <em class="parameter"><code>href</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, unsets
1481 the currently set icon. <em class="parameter"><code>href</code></em> can either be a full URL for the icon
1482 file or the icon name following the Icon Naming specification.
1483 </p>
1484 <p>
1485 If no bookmark for <em class="parameter"><code>uri</code></em> is found one is created.
1486 </p>
1487 <div class="variablelist"><table border="0">
1488 <col align="left" valign="top">
1489 <tbody>
1490 <tr>
1491 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1492 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1493 </td>
1494 </tr>
1495 <tr>
1496 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1497 <td>a valid URI
1498 </td>
1499 </tr>
1500 <tr>
1501 <td><p><span class="term"><em class="parameter"><code>href</code></em> :</span></p></td>
1502 <td>the URI of the icon for the bookmark, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1503 </td>
1504 </tr>
1505 <tr>
1506 <td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
1507 <td>the MIME type of the icon for the bookmark
1508 </td>
1509 </tr>
1510 </tbody>
1511 </table></div>
1512 <p class="since">Since 2.12</p>
1513 </div>
1514 <hr>
1515 <div class="refsect2" title="g_bookmark_file_set_added ()">
1516 <a name="g-bookmark-file-set-added"></a><h3>g_bookmark_file_set_added ()</h3>
1517 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_added           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1518                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1519                                                          <em class="parameter"><code><span class="type">time_t</span> added</code></em>);</pre>
1520 <p>
1521 Sets the time the bookmark for <em class="parameter"><code>uri</code></em> was added into <em class="parameter"><code>bookmark</code></em>.
1522 </p>
1523 <p>
1524 If no bookmark for <em class="parameter"><code>uri</code></em> is found then it is created.
1525 </p>
1526 <div class="variablelist"><table border="0">
1527 <col align="left" valign="top">
1528 <tbody>
1529 <tr>
1530 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1531 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1532 </td>
1533 </tr>
1534 <tr>
1535 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1536 <td>a valid URI
1537 </td>
1538 </tr>
1539 <tr>
1540 <td><p><span class="term"><em class="parameter"><code>added</code></em> :</span></p></td>
1541 <td>a timestamp or -1 to use the current time
1542 </td>
1543 </tr>
1544 </tbody>
1545 </table></div>
1546 <p class="since">Since 2.12</p>
1547 </div>
1548 <hr>
1549 <div class="refsect2" title="g_bookmark_file_set_groups ()">
1550 <a name="g-bookmark-file-set-groups"></a><h3>g_bookmark_file_set_groups ()</h3>
1551 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_groups          (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1552                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1553                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **groups</code></em>,
1554                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
1555 <p>
1556 Sets a list of group names for the item with URI <em class="parameter"><code>uri</code></em>.  Each previously
1557 set group name list is removed.
1558 </p>
1559 <p>
1560 If <em class="parameter"><code>uri</code></em> cannot be found then an item for it is created.
1561 </p>
1562 <div class="variablelist"><table border="0">
1563 <col align="left" valign="top">
1564 <tbody>
1565 <tr>
1566 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1567 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1568 </td>
1569 </tr>
1570 <tr>
1571 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1572 <td>an item's URI
1573 </td>
1574 </tr>
1575 <tr>
1576 <td><p><span class="term"><em class="parameter"><code>groups</code></em> :</span></p></td>
1577 <td>an array of group names, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to remove all groups
1578 </td>
1579 </tr>
1580 <tr>
1581 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1582 <td>number of group name values in <em class="parameter"><code>groups</code></em>
1583 </td>
1584 </tr>
1585 </tbody>
1586 </table></div>
1587 <p class="since">Since 2.12</p>
1588 </div>
1589 <hr>
1590 <div class="refsect2" title="g_bookmark_file_set_modified ()">
1591 <a name="g-bookmark-file-set-modified"></a><h3>g_bookmark_file_set_modified ()</h3>
1592 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_modified        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1593                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1594                                                          <em class="parameter"><code><span class="type">time_t</span> modified</code></em>);</pre>
1595 <p>
1596 Sets the last time the bookmark for <em class="parameter"><code>uri</code></em> was last modified.
1597 </p>
1598 <p>
1599 If no bookmark for <em class="parameter"><code>uri</code></em> is found then it is created.
1600 </p>
1601 <p>
1602 The "modified" time should only be set when the bookmark's meta-data
1603 was actually changed.  Every function of <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> that
1604 modifies a bookmark also changes the modification time, except for
1605 <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-set-visited" title="g_bookmark_file_set_visited ()"><code class="function">g_bookmark_file_set_visited()</code></a>.
1606 </p>
1607 <div class="variablelist"><table border="0">
1608 <col align="left" valign="top">
1609 <tbody>
1610 <tr>
1611 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1612 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1613 </td>
1614 </tr>
1615 <tr>
1616 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1617 <td>a valid URI
1618 </td>
1619 </tr>
1620 <tr>
1621 <td><p><span class="term"><em class="parameter"><code>modified</code></em> :</span></p></td>
1622 <td>a timestamp or -1 to use the current time
1623 </td>
1624 </tr>
1625 </tbody>
1626 </table></div>
1627 <p class="since">Since 2.12</p>
1628 </div>
1629 <hr>
1630 <div class="refsect2" title="g_bookmark_file_set_visited ()">
1631 <a name="g-bookmark-file-set-visited"></a><h3>g_bookmark_file_set_visited ()</h3>
1632 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_set_visited         (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1633                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1634                                                          <em class="parameter"><code><span class="type">time_t</span> visited</code></em>);</pre>
1635 <p>
1636 Sets the time the bookmark for <em class="parameter"><code>uri</code></em> was last visited.
1637 </p>
1638 <p>
1639 If no bookmark for <em class="parameter"><code>uri</code></em> is found then it is created.
1640 </p>
1641 <p>
1642 The "visited" time should only be set if the bookmark was launched,
1643 either using the command line retrieved by <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-app-info" title="g_bookmark_file_get_app_info ()"><code class="function">g_bookmark_file_get_app_info()</code></a>
1644 or by the default application for the bookmark's MIME type, retrieved
1645 using <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-mime-type" title="g_bookmark_file_get_mime_type ()"><code class="function">g_bookmark_file_get_mime_type()</code></a>.  Changing the "visited" time
1646 does not affect the "modified" time.
1647 </p>
1648 <div class="variablelist"><table border="0">
1649 <col align="left" valign="top">
1650 <tbody>
1651 <tr>
1652 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1653 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1654 </td>
1655 </tr>
1656 <tr>
1657 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1658 <td>a valid URI
1659 </td>
1660 </tr>
1661 <tr>
1662 <td><p><span class="term"><em class="parameter"><code>visited</code></em> :</span></p></td>
1663 <td>a timestamp or -1 to use the current time
1664 </td>
1665 </tr>
1666 </tbody>
1667 </table></div>
1668 <p class="since">Since 2.12</p>
1669 </div>
1670 <hr>
1671 <div class="refsect2" title="g_bookmark_file_set_app_info ()">
1672 <a name="g-bookmark-file-set-app-info"></a><h3>g_bookmark_file_set_app_info ()</h3>
1673 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_set_app_info        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1674                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1675                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
1676                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *exec</code></em>,
1677                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> count</code></em>,
1678                                                          <em class="parameter"><code><span class="type">time_t</span> stamp</code></em>,
1679                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1680 <p>
1681 Sets the meta-data of application <em class="parameter"><code>name</code></em> inside the list of
1682 applications that have registered a bookmark for <em class="parameter"><code>uri</code></em> inside
1683 <em class="parameter"><code>bookmark</code></em>.
1684 </p>
1685 <p>
1686 You should rarely use this function; use <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-add-application" title="g_bookmark_file_add_application ()"><code class="function">g_bookmark_file_add_application()</code></a>
1687 and <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-remove-application" title="g_bookmark_file_remove_application ()"><code class="function">g_bookmark_file_remove_application()</code></a> instead.
1688 </p>
1689 <p>
1690 <em class="parameter"><code>name</code></em> can be any UTF-8 encoded string used to identify an
1691 application.
1692 <em class="parameter"><code>exec</code></em> can have one of these two modifiers: "<code class="literal">f</code>", which will
1693 be expanded as the local file name retrieved from the bookmark's
1694 URI; "<code class="literal">u</code>", which will be expanded as the bookmark's URI.
1695 The expansion is done automatically when retrieving the stored
1696 command line using the <a class="link" href="glib-Bookmark-file-parser.html#g-bookmark-file-get-app-info" title="g_bookmark_file_get_app_info ()"><code class="function">g_bookmark_file_get_app_info()</code></a> function.
1697 <em class="parameter"><code>count</code></em> is the number of times the application has registered the
1698 bookmark; if is &lt; 0, the current registration count will be increased
1699 by one, if is 0, the application with <em class="parameter"><code>name</code></em> will be removed from
1700 the list of registered applications.
1701 <em class="parameter"><code>stamp</code></em> is the Unix time of the last registration; if it is -1, the
1702 current time will be used.
1703 </p>
1704 <p>
1705 If you try to remove an application by setting its registration count to
1706 zero, and no bookmark for <em class="parameter"><code>uri</code></em> is found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
1707 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>; similarly,
1708 in the event that no application <em class="parameter"><code>name</code></em> has registered a bookmark
1709 for <em class="parameter"><code>uri</code></em>,  <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and error is set to
1710 <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</span></a>.  Otherwise, if no bookmark
1711 for <em class="parameter"><code>uri</code></em> is found, one is created.
1712 </p>
1713 <div class="variablelist"><table border="0">
1714 <col align="left" valign="top">
1715 <tbody>
1716 <tr>
1717 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1718 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1719 </td>
1720 </tr>
1721 <tr>
1722 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1723 <td>a valid URI
1724 </td>
1725 </tr>
1726 <tr>
1727 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1728 <td>an application's name
1729 </td>
1730 </tr>
1731 <tr>
1732 <td><p><span class="term"><em class="parameter"><code>exec</code></em> :</span></p></td>
1733 <td>an application's command line
1734 </td>
1735 </tr>
1736 <tr>
1737 <td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
1738 <td>the number of registrations done for this application
1739 </td>
1740 </tr>
1741 <tr>
1742 <td><p><span class="term"><em class="parameter"><code>stamp</code></em> :</span></p></td>
1743 <td>the time of the last registration for this application
1744 </td>
1745 </tr>
1746 <tr>
1747 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1748 <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>
1749 </td>
1750 </tr>
1751 <tr>
1752 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1753 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the application's meta-data was successfully
1754   changed.
1755
1756 </td>
1757 </tr>
1758 </tbody>
1759 </table></div>
1760 <p class="since">Since 2.12</p>
1761 </div>
1762 <hr>
1763 <div class="refsect2" title="g_bookmark_file_add_group ()">
1764 <a name="g-bookmark-file-add-group"></a><h3>g_bookmark_file_add_group ()</h3>
1765 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_add_group           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1766                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1767                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group</code></em>);</pre>
1768 <p>
1769 Adds <em class="parameter"><code>group</code></em> to the list of groups to which the bookmark for <em class="parameter"><code>uri</code></em>
1770 belongs to.
1771 </p>
1772 <p>
1773 If no bookmark for <em class="parameter"><code>uri</code></em> is found then it is created.
1774 </p>
1775 <div class="variablelist"><table border="0">
1776 <col align="left" valign="top">
1777 <tbody>
1778 <tr>
1779 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1780 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1781 </td>
1782 </tr>
1783 <tr>
1784 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1785 <td>a valid URI
1786 </td>
1787 </tr>
1788 <tr>
1789 <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1790 <td>the group name to be added
1791 </td>
1792 </tr>
1793 </tbody>
1794 </table></div>
1795 <p class="since">Since 2.12</p>
1796 </div>
1797 <hr>
1798 <div class="refsect2" title="g_bookmark_file_add_application ()">
1799 <a name="g-bookmark-file-add-application"></a><h3>g_bookmark_file_add_application ()</h3>
1800 <pre class="programlisting"><span class="returnvalue">void</span>                g_bookmark_file_add_application     (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1801                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1802                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
1803                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *exec</code></em>);</pre>
1804 <p>
1805 Adds the application with <em class="parameter"><code>name</code></em> and <em class="parameter"><code>exec</code></em> to the list of
1806 applications that have registered a bookmark for <em class="parameter"><code>uri</code></em> into
1807 <em class="parameter"><code>bookmark</code></em>.
1808 </p>
1809 <p>
1810 Every bookmark inside a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> must have at least an
1811 application registered.  Each application must provide a name, a
1812 command line useful for launching the bookmark, the number of times
1813 the bookmark has been registered by the application and the last
1814 time the application registered this bookmark.
1815 </p>
1816 <p>
1817 If <em class="parameter"><code>name</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the name of the application will be the
1818 same returned by <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-application-name" title="g_get_application_name ()"><code class="function">g_get_application_name()</code></a>; if <em class="parameter"><code>exec</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the
1819 command line will be a composition of the program name as
1820 returned by <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-prgname" title="g_get_prgname ()"><code class="function">g_get_prgname()</code></a> and the "<code class="literal">u</code>" modifier, which will be
1821 expanded to the bookmark's URI.
1822 </p>
1823 <p>
1824 This function will automatically take care of updating the
1825 registrations count and timestamping in case an application
1826 with the same <em class="parameter"><code>name</code></em> had already registered a bookmark for
1827 <em class="parameter"><code>uri</code></em> inside <em class="parameter"><code>bookmark</code></em>.
1828 </p>
1829 <p>
1830 If no bookmark for <em class="parameter"><code>uri</code></em> is found, one is created.
1831 </p>
1832 <div class="variablelist"><table border="0">
1833 <col align="left" valign="top">
1834 <tbody>
1835 <tr>
1836 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1837 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1838 </td>
1839 </tr>
1840 <tr>
1841 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1842 <td>a valid URI
1843 </td>
1844 </tr>
1845 <tr>
1846 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1847 <td>the name of the application registering the bookmark
1848   or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1849 </td>
1850 </tr>
1851 <tr>
1852 <td><p><span class="term"><em class="parameter"><code>exec</code></em> :</span></p></td>
1853 <td>command line to be used to launch the bookmark or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1854 </td>
1855 </tr>
1856 </tbody>
1857 </table></div>
1858 <p class="since">Since 2.12</p>
1859 </div>
1860 <hr>
1861 <div class="refsect2" title="g_bookmark_file_remove_group ()">
1862 <a name="g-bookmark-file-remove-group"></a><h3>g_bookmark_file_remove_group ()</h3>
1863 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_remove_group        (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1864                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1865                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *group</code></em>,
1866                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1867 <p>
1868 Removes <em class="parameter"><code>group</code></em> from the list of groups to which the bookmark
1869 for <em class="parameter"><code>uri</code></em> belongs to.
1870 </p>
1871 <p>
1872 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
1873 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1874 In the event no group was defined, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
1875 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_INVALID_VALUE</span></a>.
1876 </p>
1877 <div class="variablelist"><table border="0">
1878 <col align="left" valign="top">
1879 <tbody>
1880 <tr>
1881 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1882 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1883 </td>
1884 </tr>
1885 <tr>
1886 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1887 <td>a valid URI
1888 </td>
1889 </tr>
1890 <tr>
1891 <td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
1892 <td>the group name to be removed
1893 </td>
1894 </tr>
1895 <tr>
1896 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1897 <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>
1898 </td>
1899 </tr>
1900 <tr>
1901 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1902 <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</code></em> was successfully removed.
1903
1904 </td>
1905 </tr>
1906 </tbody>
1907 </table></div>
1908 <p class="since">Since 2.12</p>
1909 </div>
1910 <hr>
1911 <div class="refsect2" title="g_bookmark_file_remove_application ()">
1912 <a name="g-bookmark-file-remove-application"></a><h3>g_bookmark_file_remove_application ()</h3>
1913 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_remove_application  (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1914                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1915                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *name</code></em>,
1916                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1917 <p>
1918 Removes application registered with <em class="parameter"><code>name</code></em> from the list of applications
1919 that have registered a bookmark for <em class="parameter"><code>uri</code></em> inside <em class="parameter"><code>bookmark</code></em>.
1920 </p>
1921 <p>
1922 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
1923 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
1924 In the event that no application with name <em class="parameter"><code>app_name</code></em> has registered
1925 a bookmark for <em class="parameter"><code>uri</code></em>,  <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and error is set to
1926 <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</span></a>.
1927 </p>
1928 <div class="variablelist"><table border="0">
1929 <col align="left" valign="top">
1930 <tbody>
1931 <tr>
1932 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1933 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1934 </td>
1935 </tr>
1936 <tr>
1937 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1938 <td>a valid URI
1939 </td>
1940 </tr>
1941 <tr>
1942 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1943 <td>the name of the application
1944 </td>
1945 </tr>
1946 <tr>
1947 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1948 <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>
1949 </td>
1950 </tr>
1951 <tr>
1952 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1953 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the application was successfully removed.
1954
1955 </td>
1956 </tr>
1957 </tbody>
1958 </table></div>
1959 <p class="since">Since 2.12</p>
1960 </div>
1961 <hr>
1962 <div class="refsect2" title="g_bookmark_file_remove_item ()">
1963 <a name="g-bookmark-file-remove-item"></a><h3>g_bookmark_file_remove_item ()</h3>
1964 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_remove_item         (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
1965                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *uri</code></em>,
1966                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1967 <p>
1968 Removes the bookmark for <em class="parameter"><code>uri</code></em> from the bookmark file <em class="parameter"><code>bookmark</code></em>.
1969 </p>
1970 <div class="variablelist"><table border="0">
1971 <col align="left" valign="top">
1972 <tbody>
1973 <tr>
1974 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
1975 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
1976 </td>
1977 </tr>
1978 <tr>
1979 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1980 <td>a valid URI
1981 </td>
1982 </tr>
1983 <tr>
1984 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1985 <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>
1986 </td>
1987 </tr>
1988 <tr>
1989 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1990 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the bookmark was removed successfully.
1991
1992 </td>
1993 </tr>
1994 </tbody>
1995 </table></div>
1996 <p class="since">Since 2.12</p>
1997 </div>
1998 <hr>
1999 <div class="refsect2" title="g_bookmark_file_move_item ()">
2000 <a name="g-bookmark-file-move-item"></a><h3>g_bookmark_file_move_item ()</h3>
2001 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_bookmark_file_move_item           (<em class="parameter"><code><a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a> *bookmark</code></em>,
2002                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *old_uri</code></em>,
2003                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *new_uri</code></em>,
2004                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2005 <p>
2006 Changes the URI of a bookmark item from <em class="parameter"><code>old_uri</code></em> to <em class="parameter"><code>new_uri</code></em>.  Any
2007 existing bookmark for <em class="parameter"><code>new_uri</code></em> will be overwritten.  If <em class="parameter"><code>new_uri</code></em> is
2008 <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then the bookmark is removed.
2009 </p>
2010 <p>
2011 In the event the URI cannot be found, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and
2012 <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Bookmark-file-parser.html#G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><span class="type">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</span></a>.
2013 </p>
2014 <div class="variablelist"><table border="0">
2015 <col align="left" valign="top">
2016 <tbody>
2017 <tr>
2018 <td><p><span class="term"><em class="parameter"><code>bookmark</code></em> :</span></p></td>
2019 <td>a <a class="link" href="glib-Bookmark-file-parser.html#GBookmarkFile" title="GBookmarkFile"><span class="type">GBookmarkFile</span></a>
2020 </td>
2021 </tr>
2022 <tr>
2023 <td><p><span class="term"><em class="parameter"><code>old_uri</code></em> :</span></p></td>
2024 <td>a valid URI
2025 </td>
2026 </tr>
2027 <tr>
2028 <td><p><span class="term"><em class="parameter"><code>new_uri</code></em> :</span></p></td>
2029 <td>a valid URI, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2030 </td>
2031 </tr>
2032 <tr>
2033 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2034 <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>
2035 </td>
2036 </tr>
2037 <tr>
2038 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2039 <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the URI was successfully changed
2040
2041 </td>
2042 </tr>
2043 </tbody>
2044 </table></div>
2045 <p class="since">Since 2.12</p>
2046 </div>
2047 </div>
2048 </div>
2049 <div class="footer">
2050 <hr>
2051           Generated by GTK-Doc V1.15</div>
2052 </body>
2053 </html>