docs/reference/glib/html/glib-Bookmark-file-parser.html

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