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