<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
                      'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd' [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="glib-Bookmark-file-parser">
<refmeta>
<refentrytitle role="top_of_page" id="glib-Bookmark-file-parser.top_of_page">Bookmark file parser</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GLIB Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Bookmark file parser</refname>
<refpurpose>parses files containing bookmarks</refpurpose>
</refnamediv>

<refsect1 id="glib-Bookmark-file-parser.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GBookmarkFile"><returnvalue>GBookmarkFile</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-new">g_bookmark_file_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-free">g_bookmark_file_free</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-load-from-file">g_bookmark_file_load_from_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-load-from-data">g_bookmark_file_load_from_data</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-load-from-data-dirs">g_bookmark_file_load_from_data_dirs</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-to-data">g_bookmark_file_to_data</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-to-file">g_bookmark_file_to_file</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-has-item">g_bookmark_file_has_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-has-group">g_bookmark_file_has_group</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-has-application">g_bookmark_file_has_application</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-size">g_bookmark_file_get_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;**
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-uris">g_bookmark_file_get_uris</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-title">g_bookmark_file_get_title</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-description">g_bookmark_file_get_description</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-mime-type">g_bookmark_file_get_mime_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-is-private">g_bookmark_file_get_is_private</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-icon">g_bookmark_file_get_icon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="time-t"><returnvalue>time_t</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-added">g_bookmark_file_get_added</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GDateTime"><returnvalue>GDateTime</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-added-date-time">g_bookmark_file_get_added_date_time</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="time-t"><returnvalue>time_t</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-modified">g_bookmark_file_get_modified</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GDateTime"><returnvalue>GDateTime</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-modified-date-time">g_bookmark_file_get_modified_date_time</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="time-t"><returnvalue>time_t</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-visited">g_bookmark_file_get_visited</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GDateTime"><returnvalue>GDateTime</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-visited-date-time">g_bookmark_file_get_visited_date_time</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;**
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-groups">g_bookmark_file_get_groups</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;**
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-applications">g_bookmark_file_get_applications</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-app-info">g_bookmark_file_get_app_info</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-get-application-info">g_bookmark_file_get_application_info</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-title">g_bookmark_file_set_title</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-description">g_bookmark_file_set_description</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-mime-type">g_bookmark_file_set_mime_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-is-private">g_bookmark_file_set_is_private</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-icon">g_bookmark_file_set_icon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-added">g_bookmark_file_set_added</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-added-date-time">g_bookmark_file_set_added_date_time</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-groups">g_bookmark_file_set_groups</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-modified">g_bookmark_file_set_modified</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-modified-date-time">g_bookmark_file_set_modified_date_time</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-visited">g_bookmark_file_set_visited</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-visited-date-time">g_bookmark_file_set_visited_date_time</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-app-info">g_bookmark_file_set_app_info</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-set-application-info">g_bookmark_file_set_application_info</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-add-group">g_bookmark_file_add_group</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-add-application">g_bookmark_file_add_application</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-remove-group">g_bookmark_file_remove_group</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-remove-application">g_bookmark_file_remove_application</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-remove-item">g_bookmark_file_remove_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-bookmark-file-move-item">g_bookmark_file_move_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="glib-Bookmark-file-parser.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GBookmarkFile">GBookmarkFile</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-BOOKMARK-FILE-ERROR:CAPS">G_BOOKMARK_FILE_ERROR</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GBookmarkFileError">GBookmarkFileError</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 id="glib-Bookmark-file-parser.includes"><title>Includes</title><synopsis>#include &lt;glib.h&gt;
#include &lt;glib/gprintf.h&gt;
</synopsis></refsect1>

<refsect1 id="glib-Bookmark-file-parser.description" role="desc">
<title role="desc.title">Description</title>
<para>GBookmarkFile lets you parse, edit or create files containing bookmarks
to URI, along with some meta-data about the resource pointed by the URI
like its MIME type, the application that is registering the bookmark and
the icon that should be used to represent the bookmark. The data is stored
using the
<ulink url="http://www.gnome.org/~ebassi/bookmark-spec">Desktop Bookmark Specification</ulink>.</para>
<para>The syntax of the bookmark files is described in detail inside the
Desktop Bookmark Specification, here is a quick summary: bookmark
files use a sub-class of the XML Bookmark Exchange Language
specification, consisting of valid UTF-8 encoded XML, under the
&lt;xbel> root element; each bookmark is stored inside a
&lt;bookmark> element, using its URI: no relative paths can
be used inside a bookmark file. The bookmark may have a user defined
title and description, to be used instead of the URI. Under the
&lt;metadata> element, with its owner attribute set to
<literal>http://freedesktop.org</literal>, is stored the meta-data about a resource
pointed by its URI. The meta-data consists of the resource's MIME
type; the applications that have registered a bookmark; the groups
to which a bookmark belongs to; a visibility flag, used to set the
bookmark as "private" to the applications and groups that has it
registered; the URI and MIME type of an icon, to be used when
displaying the bookmark inside a GUI.</para>
<para>Here is an example of a bookmark file:
<ulink url="https://git.gnome.org/browse/glib/tree/glib/tests/bookmarks.xbel">bookmarks.xbel</ulink></para>
<para>A bookmark file might contain more than one bookmark; each bookmark
is accessed through its URI.</para>
<para>The important caveat of bookmark files is that when you add a new
bookmark you must also add the application that is registering it, using
<link linkend="g-bookmark-file-add-application"><function>g_bookmark_file_add_application()</function></link> or <link linkend="g-bookmark-file-set-application-info"><function>g_bookmark_file_set_application_info()</function></link>.
If a bookmark has no applications then it won't be dumped when creating
the on disk representation, using <link linkend="g-bookmark-file-to-data"><function>g_bookmark_file_to_data()</function></link> or
<link linkend="g-bookmark-file-to-file"><function>g_bookmark_file_to_file()</function></link>.</para>
<para>The <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> parser was added in GLib 2.12.</para>

</refsect1>
<refsect1 id="glib-Bookmark-file-parser.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="g-bookmark-file-new" role="function" condition="since:2.12">
<title>g_bookmark_file_new&#160;()</title>
<indexterm zone="g-bookmark-file-new" role="2.12"><primary sortas="bookmark_file_new">g_bookmark_file_new</primary></indexterm>
<programlisting language="C"><link linkend="GBookmarkFile"><returnvalue>GBookmarkFile</returnvalue></link>&#160;*
g_bookmark_file_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new empty <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> object.</para>
<para>Use <link linkend="g-bookmark-file-load-from-file"><function>g_bookmark_file_load_from_file()</function></link>, <link linkend="g-bookmark-file-load-from-data"><function>g_bookmark_file_load_from_data()</function></link>
or <link linkend="g-bookmark-file-load-from-data-dirs"><function>g_bookmark_file_load_from_data_dirs()</function></link> to read an existing bookmark
file.</para>

<para><emphasis role="annotation">[<acronym>constructor</acronym>]</emphasis></para><refsect3 id="g-bookmark-file-new.returns" role="returns">
<title>Returns</title>
<para> an empty <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-free" role="function" condition="since:2.12">
<title>g_bookmark_file_free&#160;()</title>
<indexterm zone="g-bookmark-file-free" role="2.12"><primary sortas="bookmark_file_free">g_bookmark_file_free</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_free (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>);</programlisting>
<para>Frees a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link>.</para>
<refsect3 id="g-bookmark-file-free.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-load-from-file" role="function" condition="since:2.12">
<title>g_bookmark_file_load_from_file&#160;()</title>
<indexterm zone="g-bookmark-file-load-from-file" role="2.12"><primary sortas="bookmark_file_load_from_file">g_bookmark_file_load_from_file</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_load_from_file (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>,
                                <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Loads a desktop bookmark file into an empty <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> structure.
If the file could not be loaded then <parameter>error</parameter>
 is set to either a <link linkend="GFileError"><type>GFileError</type></link>
or <link linkend="GBookmarkFileError"><type>GBookmarkFileError</type></link>.</para>
<refsect3 id="g-bookmark-file-load-from-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>an empty <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> struct</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>filename</para></entry>
<entry role="parameter_description"><para>the path of a filename to load, in the
GLib file name encoding. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-load-from-file.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if a desktop bookmark file could be loaded</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-load-from-data" role="function" condition="since:2.12">
<title>g_bookmark_file_load_from_data&#160;()</title>
<indexterm zone="g-bookmark-file-load-from-data" role="2.12"><primary sortas="bookmark_file_load_from_data">g_bookmark_file_load_from_data</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_load_from_data (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *data</parameter>,
                                <parameter><link linkend="gsize"><type>gsize</type></link> length</parameter>,
                                <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Loads a bookmark file from memory into an empty <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link>
structure.  If the object cannot be created then <parameter>error</parameter>
 is set to a
<link linkend="GBookmarkFileError"><type>GBookmarkFileError</type></link>.</para>
<refsect3 id="g-bookmark-file-load-from-data.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>an empty <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> struct</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>desktop bookmarks
loaded in memory. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>array</acronym> length=length][<acronym>element-type</acronym> guint8]</emphasis></entry></row>
<row><entry role="parameter_name"><para>length</para></entry>
<entry role="parameter_description"><para>the length of <parameter>data</parameter>
in bytes</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-load-from-data.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if a desktop bookmark could be loaded.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-load-from-data-dirs" role="function" condition="since:2.12">
<title>g_bookmark_file_load_from_data_dirs&#160;()</title>
<indexterm zone="g-bookmark-file-load-from-data-dirs" role="2.12"><primary sortas="bookmark_file_load_from_data_dirs">g_bookmark_file_load_from_data_dirs</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_load_from_data_dirs (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *file</parameter>,
                                     <parameter><link linkend="gchar"><type>gchar</type></link> **full_path</parameter>,
                                     <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>This function looks for a desktop bookmark file named <parameter>file</parameter>
 in the
paths returned from <link linkend="g-get-user-data-dir"><function>g_get_user_data_dir()</function></link> and <link linkend="g-get-system-data-dirs"><function>g_get_system_data_dirs()</function></link>,
loads the file into <parameter>bookmark</parameter>
 and returns the file's full path in
<parameter>full_path</parameter>
.  If the file could not be loaded then <parameter>error</parameter>
 is
set to either a <link linkend="GFileError"><type>GFileError</type></link> or <link linkend="GBookmarkFileError"><type>GBookmarkFileError</type></link>.</para>
<refsect3 id="g-bookmark-file-load-from-data-dirs.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>file</para></entry>
<entry role="parameter_description"><para>a relative path to a filename to open and parse. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>full_path</para></entry>
<entry role="parameter_description"><para>return location for a string
containing the full path of the file, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>][<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-load-from-data-dirs.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if a key file could be loaded, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-to-data" role="function" condition="since:2.12">
<title>g_bookmark_file_to_data&#160;()</title>
<indexterm zone="g-bookmark-file-to-data" role="2.12"><primary sortas="bookmark_file_to_data">g_bookmark_file_to_data</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
g_bookmark_file_to_data (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                         <parameter><link linkend="gsize"><type>gsize</type></link> *length</parameter>,
                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>This function outputs <parameter>bookmark</parameter>
 as a string.</para>
<refsect3 id="g-bookmark-file-to-data.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>length</para></entry>
<entry role="parameter_description"><para>return location for the length of the returned string, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-to-data.returns" role="returns">
<title>Returns</title>
<para>a newly allocated string holding the contents of the <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link>. </para>
<para><emphasis role="annotation">[<acronym>array</acronym> length=length][<acronym>element-type</acronym> guint8]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-to-file" role="function" condition="since:2.12">
<title>g_bookmark_file_to_file&#160;()</title>
<indexterm zone="g-bookmark-file-to-file" role="2.12"><primary sortas="bookmark_file_to_file">g_bookmark_file_to_file</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_to_file (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                         <parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>,
                         <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>This function outputs <parameter>bookmark</parameter>
 into a file.  The write process is
guaranteed to be atomic by using <link linkend="g-file-set-contents"><function>g_file_set_contents()</function></link> internally.</para>
<refsect3 id="g-bookmark-file-to-file.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>filename</para></entry>
<entry role="parameter_description"><para>path of the output file. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> filename]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-to-file.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the file was successfully written.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-has-item" role="function" condition="since:2.12">
<title>g_bookmark_file_has_item&#160;()</title>
<indexterm zone="g-bookmark-file-has-item" role="2.12"><primary sortas="bookmark_file_has_item">g_bookmark_file_has_item</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_has_item (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>);</programlisting>
<para>Looks whether the desktop bookmark has an item with its URI set to <parameter>uri</parameter>
.</para>
<refsect3 id="g-bookmark-file-has-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-has-item.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>uri</parameter>
is inside <parameter>bookmark</parameter>
, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-has-group" role="function" condition="since:2.12">
<title>g_bookmark_file_has_group&#160;()</title>
<indexterm zone="g-bookmark-file-has-group" role="2.12"><primary sortas="bookmark_file_has_group">g_bookmark_file_has_group</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_has_group (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *group</parameter>,
                           <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Checks whether <parameter>group</parameter>
 appears in the list of groups to which
the bookmark for <parameter>uri</parameter>
 belongs to.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-has-group.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group</para></entry>
<entry role="parameter_description"><para>the group name to be searched</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-has-group.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>group</parameter>
was found.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-has-application" role="function" condition="since:2.12">
<title>g_bookmark_file_has_application&#160;()</title>
<indexterm zone="g-bookmark-file-has-application" role="2.12"><primary sortas="bookmark_file_has_application">g_bookmark_file_has_application</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_has_application (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                 <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Checks whether the bookmark for <parameter>uri</parameter>
 inside <parameter>bookmark</parameter>
 has been
registered by application <parameter>name</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-has-application.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the application</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-has-application.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the application <parameter>name</parameter>
was found</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-size" role="function" condition="since:2.12">
<title>g_bookmark_file_get_size&#160;()</title>
<indexterm zone="g-bookmark-file-get-size" role="2.12"><primary sortas="bookmark_file_get_size">g_bookmark_file_get_size</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
g_bookmark_file_get_size (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>);</programlisting>
<para>Gets the number of bookmarks inside <parameter>bookmark</parameter>
.</para>
<refsect3 id="g-bookmark-file-get-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-size.returns" role="returns">
<title>Returns</title>
<para> the number of bookmarks</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-uris" role="function" condition="since:2.12">
<title>g_bookmark_file_get_uris&#160;()</title>
<indexterm zone="g-bookmark-file-get-uris" role="2.12"><primary sortas="bookmark_file_get_uris">g_bookmark_file_get_uris</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;**
g_bookmark_file_get_uris (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                          <parameter><link linkend="gsize"><type>gsize</type></link> *length</parameter>);</programlisting>
<para>Returns all URIs of the bookmarks in the bookmark file <parameter>bookmark</parameter>
.
The array of returned URIs will be <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated, so <parameter>length</parameter>
 may
optionally be <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<refsect3 id="g-bookmark-file-get-uris.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>length</para></entry>
<entry role="parameter_description"><para>return location for the number of returned URIs, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-uris.returns" role="returns">
<title>Returns</title>
<para>a newly allocated <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of strings.
Use <link linkend="g-strfreev"><function>g_strfreev()</function></link> to free it. </para>
<para><emphasis role="annotation">[<acronym>array</acronym> length=length][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-title" role="function" condition="since:2.12">
<title>g_bookmark_file_get_title&#160;()</title>
<indexterm zone="g-bookmark-file-get-title" role="2.12"><primary sortas="bookmark_file_get_title">g_bookmark_file_get_title</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
g_bookmark_file_get_title (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                           <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Returns the title of the bookmark for <parameter>uri</parameter>
.</para>
<para>If <parameter>uri</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, the title of <parameter>bookmark</parameter>
 is returned.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-title.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-title.returns" role="returns">
<title>Returns</title>
<para> a newly allocated string or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the specified
URI cannot be found.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-description" role="function" condition="since:2.12">
<title>g_bookmark_file_get_description&#160;()</title>
<indexterm zone="g-bookmark-file-get-description" role="2.12"><primary sortas="bookmark_file_get_description">g_bookmark_file_get_description</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
g_bookmark_file_get_description (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                 <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Retrieves the description of the bookmark for <parameter>uri</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-description.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-description.returns" role="returns">
<title>Returns</title>
<para> a newly allocated string or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the specified
URI cannot be found.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-mime-type" role="function" condition="since:2.12">
<title>g_bookmark_file_get_mime_type&#160;()</title>
<indexterm zone="g-bookmark-file-get-mime-type" role="2.12"><primary sortas="bookmark_file_get_mime_type">g_bookmark_file_get_mime_type</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
g_bookmark_file_get_mime_type (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                               <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Retrieves the MIME type of the resource pointed by <parameter>uri</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.  In the
event that the MIME type cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"><type>G_BOOKMARK_FILE_ERROR_INVALID_VALUE</type></link>.</para>
<refsect3 id="g-bookmark-file-get-mime-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-mime-type.returns" role="returns">
<title>Returns</title>
<para> a newly allocated string or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the specified
URI cannot be found.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-is-private" role="function" condition="since:2.12">
<title>g_bookmark_file_get_is_private&#160;()</title>
<indexterm zone="g-bookmark-file-get-is-private" role="2.12"><primary sortas="bookmark_file_get_is_private">g_bookmark_file_get_is_private</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_get_is_private (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets whether the private flag of the bookmark for <parameter>uri</parameter>
 is set.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.  In the
event that the private flag cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"><type>G_BOOKMARK_FILE_ERROR_INVALID_VALUE</type></link>.</para>
<refsect3 id="g-bookmark-file-get-is-private.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-is-private.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the private flag is set, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-icon" role="function" condition="since:2.12">
<title>g_bookmark_file_get_icon&#160;()</title>
<indexterm zone="g-bookmark-file-get-icon" role="2.12"><primary sortas="bookmark_file_get_icon">g_bookmark_file_get_icon</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_get_icon (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                          <parameter><link linkend="gchar"><type>gchar</type></link> **href</parameter>,
                          <parameter><link linkend="gchar"><type>gchar</type></link> **mime_type</parameter>,
                          <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets the icon of the bookmark for <parameter>uri</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-icon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>href</para></entry>
<entry role="parameter_description"><para>return location for the icon's location or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>mime_type</para></entry>
<entry role="parameter_description"><para>return location for the icon's MIME type or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-icon.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the icon for the bookmark for the URI was found.
You should free the returned strings.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-added" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_get_added&#160;()</title>
<indexterm zone="g-bookmark-file-get-added" role="deprecated"><primary sortas="bookmark_file_get_added">g_bookmark_file_get_added</primary></indexterm><indexterm zone="g-bookmark-file-get-added" role="2.12"><primary sortas="bookmark_file_get_added">g_bookmark_file_get_added</primary></indexterm>
<programlisting language="C"><link linkend="time-t"><returnvalue>time_t</returnvalue></link>
g_bookmark_file_get_added (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                           <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_get_added</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-get-added-date-time"><function>g_bookmark_file_get_added_date_time()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Gets the time the bookmark for <parameter>uri</parameter>
 was added to <parameter>bookmark</parameter>
</para>
<para>In the event the URI cannot be found, -1 is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-added.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-added.returns" role="returns">
<title>Returns</title>
<para> a timestamp</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-added-date-time" role="function" condition="since:2.66">
<title>g_bookmark_file_get_added_date_time&#160;()</title>
<indexterm zone="g-bookmark-file-get-added-date-time" role="2.66"><primary sortas="bookmark_file_get_added_date_time">g_bookmark_file_get_added_date_time</primary></indexterm>
<programlisting language="C"><link linkend="GDateTime"><returnvalue>GDateTime</returnvalue></link>&#160;*
g_bookmark_file_get_added_date_time (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                     <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                     <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets the time the bookmark for <parameter>uri</parameter>
 was added to <parameter>bookmark</parameter>
</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-added-date-time.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-added-date-time.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GDateTime"><type>GDateTime</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-modified" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_get_modified&#160;()</title>
<indexterm zone="g-bookmark-file-get-modified" role="deprecated"><primary sortas="bookmark_file_get_modified">g_bookmark_file_get_modified</primary></indexterm><indexterm zone="g-bookmark-file-get-modified" role="2.12"><primary sortas="bookmark_file_get_modified">g_bookmark_file_get_modified</primary></indexterm>
<programlisting language="C"><link linkend="time-t"><returnvalue>time_t</returnvalue></link>
g_bookmark_file_get_modified (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                              <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_get_modified</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-get-modified-date-time"><function>g_bookmark_file_get_modified_date_time()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Gets the time when the bookmark for <parameter>uri</parameter>
 was last modified.</para>
<para>In the event the URI cannot be found, -1 is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-modified.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-modified.returns" role="returns">
<title>Returns</title>
<para> a timestamp</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-modified-date-time" role="function" condition="since:2.66">
<title>g_bookmark_file_get_modified_date_time&#160;()</title>
<indexterm zone="g-bookmark-file-get-modified-date-time" role="2.66"><primary sortas="bookmark_file_get_modified_date_time">g_bookmark_file_get_modified_date_time</primary></indexterm>
<programlisting language="C"><link linkend="GDateTime"><returnvalue>GDateTime</returnvalue></link>&#160;*
g_bookmark_file_get_modified_date_time
                               (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets the time when the bookmark for <parameter>uri</parameter>
 was last modified.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-modified-date-time.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-modified-date-time.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GDateTime"><type>GDateTime</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-visited" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_get_visited&#160;()</title>
<indexterm zone="g-bookmark-file-get-visited" role="deprecated"><primary sortas="bookmark_file_get_visited">g_bookmark_file_get_visited</primary></indexterm><indexterm zone="g-bookmark-file-get-visited" role="2.12"><primary sortas="bookmark_file_get_visited">g_bookmark_file_get_visited</primary></indexterm>
<programlisting language="C"><link linkend="time-t"><returnvalue>time_t</returnvalue></link>
g_bookmark_file_get_visited (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                             <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                             <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_get_visited</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-get-visited-date-time"><function>g_bookmark_file_get_visited_date_time()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Gets the time the bookmark for <parameter>uri</parameter>
 was last visited.</para>
<para>In the event the URI cannot be found, -1 is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-visited.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-visited.returns" role="returns">
<title>Returns</title>
<para> a timestamp.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-visited-date-time" role="function" condition="since:2.66">
<title>g_bookmark_file_get_visited_date_time&#160;()</title>
<indexterm zone="g-bookmark-file-get-visited-date-time" role="2.66"><primary sortas="bookmark_file_get_visited_date_time">g_bookmark_file_get_visited_date_time</primary></indexterm>
<programlisting language="C"><link linkend="GDateTime"><returnvalue>GDateTime</returnvalue></link>&#160;*
g_bookmark_file_get_visited_date_time (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                       <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                       <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets the time the bookmark for <parameter>uri</parameter>
 was last visited.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-visited-date-time.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-visited-date-time.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GDateTime"><type>GDateTime</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-groups" role="function" condition="since:2.12">
<title>g_bookmark_file_get_groups&#160;()</title>
<indexterm zone="g-bookmark-file-get-groups" role="2.12"><primary sortas="bookmark_file_get_groups">g_bookmark_file_get_groups</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;**
g_bookmark_file_get_groups (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                            <parameter><link linkend="gsize"><type>gsize</type></link> *length</parameter>,
                            <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Retrieves the list of group names of the bookmark for <parameter>uri</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<para>The returned array is <link linkend="NULL:CAPS"><literal>NULL</literal></link> terminated, so <parameter>length</parameter>
 may optionally
be <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<refsect3 id="g-bookmark-file-get-groups.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>length</para></entry>
<entry role="parameter_description"><para>return location for the length of the returned string, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-groups.returns" role="returns">
<title>Returns</title>
<para>a newly allocated <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of group names.
Use <link linkend="g-strfreev"><function>g_strfreev()</function></link> to free it. </para>
<para><emphasis role="annotation">[<acronym>array</acronym> length=length][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-applications" role="function" condition="since:2.12">
<title>g_bookmark_file_get_applications&#160;()</title>
<indexterm zone="g-bookmark-file-get-applications" role="2.12"><primary sortas="bookmark_file_get_applications">g_bookmark_file_get_applications</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;**
g_bookmark_file_get_applications (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                  <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                  <parameter><link linkend="gsize"><type>gsize</type></link> *length</parameter>,
                                  <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Retrieves the names of the applications that have registered the
bookmark for <parameter>uri</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-get-applications.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>length</para></entry>
<entry role="parameter_description"><para>return location of the length of the returned list, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-applications.returns" role="returns">
<title>Returns</title>
<para>a newly allocated <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of strings.
Use <link linkend="g-strfreev"><function>g_strfreev()</function></link> to free it. </para>
<para><emphasis role="annotation">[<acronym>array</acronym> length=length][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-app-info" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_get_app_info&#160;()</title>
<indexterm zone="g-bookmark-file-get-app-info" role="deprecated"><primary sortas="bookmark_file_get_app_info">g_bookmark_file_get_app_info</primary></indexterm><indexterm zone="g-bookmark-file-get-app-info" role="2.12"><primary sortas="bookmark_file_get_app_info">g_bookmark_file_get_app_info</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_get_app_info (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                              <parameter><link linkend="gchar"><type>gchar</type></link> **exec</parameter>,
                              <parameter><link linkend="guint"><type>guint</type></link> *count</parameter>,
                              <parameter><link linkend="time-t"><type>time_t</type></link> *stamp</parameter>,
                              <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_get_app_info</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-get-application-info"><function>g_bookmark_file_get_application_info()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Gets the registration information of <parameter>app_name</parameter>
 for the bookmark for
<parameter>uri</parameter>
.  See <link linkend="g-bookmark-file-set-application-info"><function>g_bookmark_file_set_application_info()</function></link> for more information about
the returned data.</para>
<para>The string returned in <parameter>app_exec</parameter>
 must be freed.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.  In the
event that no application with name <parameter>app_name</parameter>
 has registered a bookmark
for <parameter>uri</parameter>
,  <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and error is set to
<link linkend="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><type>G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</type></link>. In the event that unquoting
the command line fails, an error of the <link linkend="G-SHELL-ERROR:CAPS"><type>G_SHELL_ERROR</type></link> domain is
set and <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned.</para>
<refsect3 id="g-bookmark-file-get-app-info.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>an application's name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>exec</para></entry>
<entry role="parameter_description"><para>return location for the command line of the application, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>count</para></entry>
<entry role="parameter_description"><para>return location for the registration count, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>stamp</para></entry>
<entry role="parameter_description"><para>return location for the last registration time, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-app-info.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-get-application-info" role="function" condition="since:2.66">
<title>g_bookmark_file_get_application_info&#160;()</title>
<indexterm zone="g-bookmark-file-get-application-info" role="2.66"><primary sortas="bookmark_file_get_application_info">g_bookmark_file_get_application_info</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_get_application_info (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                      <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                      <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                      <parameter><link linkend="char"><type>char</type></link> **exec</parameter>,
                                      <parameter>unsigned <link linkend="int"><type>int</type></link> *count</parameter>,
                                      <parameter><link linkend="GDateTime"><type>GDateTime</type></link> **stamp</parameter>,
                                      <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Gets the registration information of <parameter>app_name</parameter>
 for the bookmark for
<parameter>uri</parameter>
.  See <link linkend="g-bookmark-file-set-application-info"><function>g_bookmark_file_set_application_info()</function></link> for more information about
the returned data.</para>
<para>The string returned in <parameter>app_exec</parameter>
 must be freed.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.  In the
event that no application with name <parameter>app_name</parameter>
 has registered a bookmark
for <parameter>uri</parameter>
,  <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and error is set to
<link linkend="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><type>G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</type></link>. In the event that unquoting
the command line fails, an error of the <link linkend="G-SHELL-ERROR:CAPS"><type>G_SHELL_ERROR</type></link> domain is
set and <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned.</para>
<refsect3 id="g-bookmark-file-get-application-info.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>an application's name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>exec</para></entry>
<entry role="parameter_description"><para>return location for the command line of the application, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>count</para></entry>
<entry role="parameter_description"><para>return location for the registration count, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>stamp</para></entry>
<entry role="parameter_description"><para>return location for the last registration time, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>][<acronym>transfer none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-get-application-info.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-title" role="function" condition="since:2.12">
<title>g_bookmark_file_set_title&#160;()</title>
<indexterm zone="g-bookmark-file-set-title" role="2.12"><primary sortas="bookmark_file_set_title">g_bookmark_file_set_title</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_title (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *title</parameter>);</programlisting>
<para>Sets <parameter>title</parameter>
 as the title of the bookmark for <parameter>uri</parameter>
 inside the
bookmark file <parameter>bookmark</parameter>
.</para>
<para>If <parameter>uri</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, the title of <parameter>bookmark</parameter>
 is set.</para>
<para>If a bookmark for <parameter>uri</parameter>
 cannot be found then it is created.</para>
<refsect3 id="g-bookmark-file-set-title.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>title</para></entry>
<entry role="parameter_description"><para>a UTF-8 encoded string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-description" role="function" condition="since:2.12">
<title>g_bookmark_file_set_description&#160;()</title>
<indexterm zone="g-bookmark-file-set-description" role="2.12"><primary sortas="bookmark_file_set_description">g_bookmark_file_set_description</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_description (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *description</parameter>);</programlisting>
<para>Sets <parameter>description</parameter>
 as the description of the bookmark for <parameter>uri</parameter>
.</para>
<para>If <parameter>uri</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, the description of <parameter>bookmark</parameter>
 is set.</para>
<para>If a bookmark for <parameter>uri</parameter>
 cannot be found then it is created.</para>
<refsect3 id="g-bookmark-file-set-description.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>description</para></entry>
<entry role="parameter_description"><para>a string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-mime-type" role="function" condition="since:2.12">
<title>g_bookmark_file_set_mime_type&#160;()</title>
<indexterm zone="g-bookmark-file-set-mime-type" role="2.12"><primary sortas="bookmark_file_set_mime_type">g_bookmark_file_set_mime_type</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_mime_type (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *mime_type</parameter>);</programlisting>
<para>Sets <parameter>mime_type</parameter>
 as the MIME type of the bookmark for <parameter>uri</parameter>
.</para>
<para>If a bookmark for <parameter>uri</parameter>
 cannot be found then it is created.</para>
<refsect3 id="g-bookmark-file-set-mime-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mime_type</para></entry>
<entry role="parameter_description"><para>a MIME type</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-is-private" role="function" condition="since:2.12">
<title>g_bookmark_file_set_is_private&#160;()</title>
<indexterm zone="g-bookmark-file-set-is-private" role="2.12"><primary sortas="bookmark_file_set_is_private">g_bookmark_file_set_is_private</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_is_private (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> is_private</parameter>);</programlisting>
<para>Sets the private flag of the bookmark for <parameter>uri</parameter>
.</para>
<para>If a bookmark for <parameter>uri</parameter>
 cannot be found then it is created.</para>
<refsect3 id="g-bookmark-file-set-is-private.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_private</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the bookmark should be marked as private</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-icon" role="function" condition="since:2.12">
<title>g_bookmark_file_set_icon&#160;()</title>
<indexterm zone="g-bookmark-file-set-icon" role="2.12"><primary sortas="bookmark_file_set_icon">g_bookmark_file_set_icon</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_icon (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *href</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *mime_type</parameter>);</programlisting>
<para>Sets the icon for the bookmark for <parameter>uri</parameter>
. If <parameter>href</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, unsets
the currently set icon. <parameter>href</parameter>
 can either be a full URL for the icon
file or the icon name following the Icon Naming specification.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found one is created.</para>
<refsect3 id="g-bookmark-file-set-icon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>href</para></entry>
<entry role="parameter_description"><para>the URI of the icon for the bookmark, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>mime_type</para></entry>
<entry role="parameter_description"><para>the MIME type of the icon for the bookmark</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-added" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_set_added&#160;()</title>
<indexterm zone="g-bookmark-file-set-added" role="deprecated"><primary sortas="bookmark_file_set_added">g_bookmark_file_set_added</primary></indexterm><indexterm zone="g-bookmark-file-set-added" role="2.12"><primary sortas="bookmark_file_set_added">g_bookmark_file_set_added</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_added (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                           <parameter><link linkend="time-t"><type>time_t</type></link> added</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_set_added</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-set-added-date-time"><function>g_bookmark_file_set_added_date_time()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Sets the time the bookmark for <parameter>uri</parameter>
 was added into <parameter>bookmark</parameter>
.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<refsect3 id="g-bookmark-file-set-added.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>added</para></entry>
<entry role="parameter_description"><para>a timestamp or -1 to use the current time</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-added-date-time" role="function" condition="since:2.66">
<title>g_bookmark_file_set_added_date_time&#160;()</title>
<indexterm zone="g-bookmark-file-set-added-date-time" role="2.66"><primary sortas="bookmark_file_set_added_date_time">g_bookmark_file_set_added_date_time</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_added_date_time (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                     <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                     <parameter><link linkend="GDateTime"><type>GDateTime</type></link> *added</parameter>);</programlisting>
<para>Sets the time the bookmark for <parameter>uri</parameter>
 was added into <parameter>bookmark</parameter>
.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<refsect3 id="g-bookmark-file-set-added-date-time.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>added</para></entry>
<entry role="parameter_description"><para>a <link linkend="GDateTime"><type>GDateTime</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-groups" role="function" condition="since:2.12">
<title>g_bookmark_file_set_groups&#160;()</title>
<indexterm zone="g-bookmark-file-set-groups" role="2.12"><primary sortas="bookmark_file_set_groups">g_bookmark_file_set_groups</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_groups (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                            <parameter>const <link linkend="gchar"><type>gchar</type></link> **groups</parameter>,
                            <parameter><link linkend="gsize"><type>gsize</type></link> length</parameter>);</programlisting>
<para>Sets a list of group names for the item with URI <parameter>uri</parameter>
.  Each previously
set group name list is removed.</para>
<para>If <parameter>uri</parameter>
 cannot be found then an item for it is created.</para>
<refsect3 id="g-bookmark-file-set-groups.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>an item's URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>groups</para></entry>
<entry role="parameter_description"><para>an array of
group names, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to remove all groups. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>array</acronym> length=length][<acronym>element-type</acronym> utf8]</emphasis></entry></row>
<row><entry role="parameter_name"><para>length</para></entry>
<entry role="parameter_description"><para>number of group name values in <parameter>groups</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-modified" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_set_modified&#160;()</title>
<indexterm zone="g-bookmark-file-set-modified" role="deprecated"><primary sortas="bookmark_file_set_modified">g_bookmark_file_set_modified</primary></indexterm><indexterm zone="g-bookmark-file-set-modified" role="2.12"><primary sortas="bookmark_file_set_modified">g_bookmark_file_set_modified</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_modified (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                              <parameter><link linkend="time-t"><type>time_t</type></link> modified</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_set_modified</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-set-modified-date-time"><function>g_bookmark_file_set_modified_date_time()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Sets the last time the bookmark for <parameter>uri</parameter>
 was last modified.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<para>The "modified" time should only be set when the bookmark's meta-data
was actually changed.  Every function of <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> that
modifies a bookmark also changes the modification time, except for
<link linkend="g-bookmark-file-set-visited-date-time"><function>g_bookmark_file_set_visited_date_time()</function></link>.</para>
<refsect3 id="g-bookmark-file-set-modified.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>modified</para></entry>
<entry role="parameter_description"><para>a timestamp or -1 to use the current time</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-modified-date-time" role="function" condition="since:2.66">
<title>g_bookmark_file_set_modified_date_time&#160;()</title>
<indexterm zone="g-bookmark-file-set-modified-date-time" role="2.66"><primary sortas="bookmark_file_set_modified_date_time">g_bookmark_file_set_modified_date_time</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_modified_date_time
                               (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                <parameter><link linkend="GDateTime"><type>GDateTime</type></link> *modified</parameter>);</programlisting>
<para>Sets the last time the bookmark for <parameter>uri</parameter>
 was last modified.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<para>The "modified" time should only be set when the bookmark's meta-data
was actually changed.  Every function of <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> that
modifies a bookmark also changes the modification time, except for
<link linkend="g-bookmark-file-set-visited-date-time"><function>g_bookmark_file_set_visited_date_time()</function></link>.</para>
<refsect3 id="g-bookmark-file-set-modified-date-time.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>modified</para></entry>
<entry role="parameter_description"><para>a <link linkend="GDateTime"><type>GDateTime</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-visited" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_set_visited&#160;()</title>
<indexterm zone="g-bookmark-file-set-visited" role="deprecated"><primary sortas="bookmark_file_set_visited">g_bookmark_file_set_visited</primary></indexterm><indexterm zone="g-bookmark-file-set-visited" role="2.12"><primary sortas="bookmark_file_set_visited">g_bookmark_file_set_visited</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_visited (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                             <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                             <parameter><link linkend="time-t"><type>time_t</type></link> visited</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_set_visited</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-set-visited-date-time"><function>g_bookmark_file_set_visited_date_time()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Sets the time the bookmark for <parameter>uri</parameter>
 was last visited.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<para>The "visited" time should only be set if the bookmark was launched,
either using the command line retrieved by <link linkend="g-bookmark-file-get-application-info"><function>g_bookmark_file_get_application_info()</function></link>
or by the default application for the bookmark's MIME type, retrieved
using <link linkend="g-bookmark-file-get-mime-type"><function>g_bookmark_file_get_mime_type()</function></link>.  Changing the "visited" time
does not affect the "modified" time.</para>
<refsect3 id="g-bookmark-file-set-visited.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>visited</para></entry>
<entry role="parameter_description"><para>a timestamp or -1 to use the current time</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-visited-date-time" role="function" condition="since:2.66">
<title>g_bookmark_file_set_visited_date_time&#160;()</title>
<indexterm zone="g-bookmark-file-set-visited-date-time" role="2.66"><primary sortas="bookmark_file_set_visited_date_time">g_bookmark_file_set_visited_date_time</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_set_visited_date_time (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                       <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                       <parameter><link linkend="GDateTime"><type>GDateTime</type></link> *visited</parameter>);</programlisting>
<para>Sets the time the bookmark for <parameter>uri</parameter>
 was last visited.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<para>The "visited" time should only be set if the bookmark was launched,
either using the command line retrieved by <link linkend="g-bookmark-file-get-application-info"><function>g_bookmark_file_get_application_info()</function></link>
or by the default application for the bookmark's MIME type, retrieved
using <link linkend="g-bookmark-file-get-mime-type"><function>g_bookmark_file_get_mime_type()</function></link>.  Changing the "visited" time
does not affect the "modified" time.</para>
<refsect3 id="g-bookmark-file-set-visited-date-time.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>visited</para></entry>
<entry role="parameter_description"><para>a <link linkend="GDateTime"><type>GDateTime</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-app-info" role="function" condition="deprecated|since:2.12">
<title>g_bookmark_file_set_app_info&#160;()</title>
<indexterm zone="g-bookmark-file-set-app-info" role="deprecated"><primary sortas="bookmark_file_set_app_info">g_bookmark_file_set_app_info</primary></indexterm><indexterm zone="g-bookmark-file-set-app-info" role="2.12"><primary sortas="bookmark_file_set_app_info">g_bookmark_file_set_app_info</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_set_app_info (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *exec</parameter>,
                              <parameter><link linkend="gint"><type>gint</type></link> count</parameter>,
                              <parameter><link linkend="time-t"><type>time_t</type></link> stamp</parameter>,
                              <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<warning><para><literal>g_bookmark_file_set_app_info</literal> has been deprecated since version 2.66 and should not be used in newly-written code.</para> <para>Use <link linkend="g-bookmark-file-set-application-info"><function>g_bookmark_file_set_application_info()</function></link> instead, as
   <literal>time_t</literal> is deprecated due to the year 2038 problem.</para>
</warning>
<para>Sets the meta-data of application <parameter>name</parameter>
 inside the list of
applications that have registered a bookmark for <parameter>uri</parameter>
 inside
<parameter>bookmark</parameter>
.</para>
<para>You should rarely use this function; use <link linkend="g-bookmark-file-add-application"><function>g_bookmark_file_add_application()</function></link>
and <link linkend="g-bookmark-file-remove-application"><function>g_bookmark_file_remove_application()</function></link> instead.</para>
<para><parameter>name</parameter>
 can be any UTF-8 encoded string used to identify an
application.
<parameter>exec</parameter>
 can have one of these two modifiers: "%f", which will
be expanded as the local file name retrieved from the bookmark's
URI; "%u", which will be expanded as the bookmark's URI.
The expansion is done automatically when retrieving the stored
command line using the <link linkend="g-bookmark-file-get-application-info"><function>g_bookmark_file_get_application_info()</function></link> function.
<parameter>count</parameter>
 is the number of times the application has registered the
bookmark; if is &lt; 0, the current registration count will be increased
by one, if is 0, the application with <parameter>name</parameter>
 will be removed from
the list of registered applications.
<parameter>stamp</parameter>
 is the Unix time of the last registration; if it is -1, the
current time will be used.</para>
<para>If you try to remove an application by setting its registration count to
zero, and no bookmark for <parameter>uri</parameter>
 is found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>; similarly,
in the event that no application <parameter>name</parameter>
 has registered a bookmark
for <parameter>uri</parameter>
,  <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and error is set to
<link linkend="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><type>G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</type></link>.  Otherwise, if no bookmark
for <parameter>uri</parameter>
 is found, one is created.</para>
<refsect3 id="g-bookmark-file-set-app-info.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>an application's name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>exec</para></entry>
<entry role="parameter_description"><para>an application's command line</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>count</para></entry>
<entry role="parameter_description"><para>the number of registrations done for this application</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>stamp</para></entry>
<entry role="parameter_description"><para>the time of the last registration for this application</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-set-app-info.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the application's meta-data was successfully
changed.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-set-application-info" role="function" condition="since:2.66">
<title>g_bookmark_file_set_application_info&#160;()</title>
<indexterm zone="g-bookmark-file-set-application-info" role="2.66"><primary sortas="bookmark_file_set_application_info">g_bookmark_file_set_application_info</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_set_application_info (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                      <parameter>const <link linkend="char"><type>char</type></link> *uri</parameter>,
                                      <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                      <parameter>const <link linkend="char"><type>char</type></link> *exec</parameter>,
                                      <parameter><link linkend="int"><type>int</type></link> count</parameter>,
                                      <parameter><link linkend="GDateTime"><type>GDateTime</type></link> *stamp</parameter>,
                                      <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Sets the meta-data of application <parameter>name</parameter>
 inside the list of
applications that have registered a bookmark for <parameter>uri</parameter>
 inside
<parameter>bookmark</parameter>
.</para>
<para>You should rarely use this function; use <link linkend="g-bookmark-file-add-application"><function>g_bookmark_file_add_application()</function></link>
and <link linkend="g-bookmark-file-remove-application"><function>g_bookmark_file_remove_application()</function></link> instead.</para>
<para><parameter>name</parameter>
 can be any UTF-8 encoded string used to identify an
application.
<parameter>exec</parameter>
 can have one of these two modifiers: "%f", which will
be expanded as the local file name retrieved from the bookmark's
URI; "%u", which will be expanded as the bookmark's URI.
The expansion is done automatically when retrieving the stored
command line using the <link linkend="g-bookmark-file-get-application-info"><function>g_bookmark_file_get_application_info()</function></link> function.
<parameter>count</parameter>
 is the number of times the application has registered the
bookmark; if is &lt; 0, the current registration count will be increased
by one, if is 0, the application with <parameter>name</parameter>
 will be removed from
the list of registered applications.
<parameter>stamp</parameter>
 is the Unix time of the last registration.</para>
<para>If you try to remove an application by setting its registration count to
zero, and no bookmark for <parameter>uri</parameter>
 is found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>; similarly,
in the event that no application <parameter>name</parameter>
 has registered a bookmark
for <parameter>uri</parameter>
,  <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and error is set to
<link linkend="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><type>G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</type></link>.  Otherwise, if no bookmark
for <parameter>uri</parameter>
 is found, one is created.</para>
<refsect3 id="g-bookmark-file-set-application-info.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>an application's name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>exec</para></entry>
<entry role="parameter_description"><para>an application's command line</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>count</para></entry>
<entry role="parameter_description"><para>the number of registrations done for this application</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>stamp</para></entry>
<entry role="parameter_description"><para>the time of the last registration for this application,
which may be <link linkend="NULL:CAPS"><literal>NULL</literal></link> if <parameter>count</parameter>
is 0. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-set-application-info.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the application's meta-data was successfully
changed.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-bookmark-file-add-group" role="function" condition="since:2.12">
<title>g_bookmark_file_add_group&#160;()</title>
<indexterm zone="g-bookmark-file-add-group" role="2.12"><primary sortas="bookmark_file_add_group">g_bookmark_file_add_group</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_add_group (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *group</parameter>);</programlisting>
<para>Adds <parameter>group</parameter>
 to the list of groups to which the bookmark for <parameter>uri</parameter>

belongs to.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found then it is created.</para>
<refsect3 id="g-bookmark-file-add-group.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group</para></entry>
<entry role="parameter_description"><para>the group name to be added</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-add-application" role="function" condition="since:2.12">
<title>g_bookmark_file_add_application&#160;()</title>
<indexterm zone="g-bookmark-file-add-application" role="2.12"><primary sortas="bookmark_file_add_application">g_bookmark_file_add_application</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_bookmark_file_add_application (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *exec</parameter>);</programlisting>
<para>Adds the application with <parameter>name</parameter>
 and <parameter>exec</parameter>
 to the list of
applications that have registered a bookmark for <parameter>uri</parameter>
 into
<parameter>bookmark</parameter>
.</para>
<para>Every bookmark inside a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> must have at least an
application registered.  Each application must provide a name, a
command line useful for launching the bookmark, the number of times
the bookmark has been registered by the application and the last
time the application registered this bookmark.</para>
<para>If <parameter>name</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, the name of the application will be the
same returned by <link linkend="g-get-application-name"><function>g_get_application_name()</function></link>; if <parameter>exec</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, the
command line will be a composition of the program name as
returned by <link linkend="g-get-prgname"><function>g_get_prgname()</function></link> and the "%u" modifier, which will be
expanded to the bookmark's URI.</para>
<para>This function will automatically take care of updating the
registrations count and timestamping in case an application
with the same <parameter>name</parameter>
 had already registered a bookmark for
<parameter>uri</parameter>
 inside <parameter>bookmark</parameter>
.</para>
<para>If no bookmark for <parameter>uri</parameter>
 is found, one is created.</para>
<refsect3 id="g-bookmark-file-add-application.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the application registering the bookmark
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>exec</para></entry>
<entry role="parameter_description"><para>command line to be used to launch the bookmark or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-remove-group" role="function" condition="since:2.12">
<title>g_bookmark_file_remove_group&#160;()</title>
<indexterm zone="g-bookmark-file-remove-group" role="2.12"><primary sortas="bookmark_file_remove_group">g_bookmark_file_remove_group</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_remove_group (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *group</parameter>,
                              <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Removes <parameter>group</parameter>
 from the list of groups to which the bookmark
for <parameter>uri</parameter>
 belongs to.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.
In the event no group was defined, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS"><type>G_BOOKMARK_FILE_ERROR_INVALID_VALUE</type></link>.</para>
<refsect3 id="g-bookmark-file-remove-group.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group</para></entry>
<entry role="parameter_description"><para>the group name to be removed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-remove-group.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>group</parameter>
was successfully removed.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-remove-application" role="function" condition="since:2.12">
<title>g_bookmark_file_remove_application&#160;()</title>
<indexterm zone="g-bookmark-file-remove-application" role="2.12"><primary sortas="bookmark_file_remove_application">g_bookmark_file_remove_application</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_remove_application (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                    <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Removes application registered with <parameter>name</parameter>
 from the list of applications
that have registered a bookmark for <parameter>uri</parameter>
 inside <parameter>bookmark</parameter>
.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.
In the event that no application with name <parameter>app_name</parameter>
 has registered
a bookmark for <parameter>uri</parameter>
,  <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and error is set to
<link linkend="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS"><type>G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</type></link>.</para>
<refsect3 id="g-bookmark-file-remove-application.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the application</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-remove-application.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the application was successfully removed.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-remove-item" role="function" condition="since:2.12">
<title>g_bookmark_file_remove_item&#160;()</title>
<indexterm zone="g-bookmark-file-remove-item" role="2.12"><primary sortas="bookmark_file_remove_item">g_bookmark_file_remove_item</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_remove_item (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                             <parameter>const <link linkend="gchar"><type>gchar</type></link> *uri</parameter>,
                             <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Removes the bookmark for <parameter>uri</parameter>
 from the bookmark file <parameter>bookmark</parameter>
.</para>
<refsect3 id="g-bookmark-file-remove-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-remove-item.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the bookmark was removed successfully.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-bookmark-file-move-item" role="function" condition="since:2.12">
<title>g_bookmark_file_move_item&#160;()</title>
<indexterm zone="g-bookmark-file-move-item" role="2.12"><primary sortas="bookmark_file_move_item">g_bookmark_file_move_item</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_bookmark_file_move_item (<parameter><link linkend="GBookmarkFile"><type>GBookmarkFile</type></link> *bookmark</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *old_uri</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *new_uri</parameter>,
                           <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para>Changes the URI of a bookmark item from <parameter>old_uri</parameter>
 to <parameter>new_uri</parameter>
.  Any
existing bookmark for <parameter>new_uri</parameter>
 will be overwritten.  If <parameter>new_uri</parameter>
 is
<link linkend="NULL:CAPS"><literal>NULL</literal></link>, then the bookmark is removed.</para>
<para>In the event the URI cannot be found, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned and
<parameter>error</parameter>
 is set to <link linkend="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS"><type>G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</type></link>.</para>
<refsect3 id="g-bookmark-file-move-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>bookmark</para></entry>
<entry role="parameter_description"><para>a <link linkend="GBookmarkFile"><type>GBookmarkFile</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>old_uri</para></entry>
<entry role="parameter_description"><para>a valid URI</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>new_uri</para></entry>
<entry role="parameter_description"><para>a valid URI, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>error</para></entry>
<entry role="parameter_description"><para>return location for a <link linkend="GError"><type>GError</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-bookmark-file-move-item.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the URI was successfully changed</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>

</refsect1>
<refsect1 id="glib-Bookmark-file-parser.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GBookmarkFile" role="struct">
<title>GBookmarkFile</title>
<indexterm zone="GBookmarkFile"><primary sortas="BookmarkFile">GBookmarkFile</primary></indexterm>
<programlisting language="C">typedef struct _GBookmarkFile GBookmarkFile;</programlisting>
<para>The <literal>GBookmarkFile</literal> structure contains only
private data and should not be directly accessed.</para>
</refsect2>
<refsect2 id="G-BOOKMARK-FILE-ERROR:CAPS" role="macro">
<title>G_BOOKMARK_FILE_ERROR</title>
<indexterm zone="G-BOOKMARK-FILE-ERROR:CAPS"><primary sortas="BOOKMARK_FILE_ERROR">G_BOOKMARK_FILE_ERROR</primary></indexterm>
<programlisting language="C">#define G_BOOKMARK_FILE_ERROR&#160;(g_bookmark_file_error_quark ())
</programlisting>
<para>Error domain for bookmark file parsing.
Errors in this domain will be from the <link linkend="GBookmarkFileError"><type>GBookmarkFileError</type></link>
enumeration. See <link linkend="GError"><type>GError</type></link> for information on error domains.</para>
</refsect2>
<refsect2 id="GBookmarkFileError" role="enum">
<title>enum GBookmarkFileError</title>
<indexterm zone="GBookmarkFileError"><primary sortas="BookmarkFileError">GBookmarkFileError</primary></indexterm>
<para>Error codes returned by bookmark file parsing.</para>
<refsect3 id="GBookmarkFileError.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-INVALID-URI:CAPS">G_BOOKMARK_FILE_ERROR_INVALID_URI</para></entry>
<entry role="enum_member_description"><para>URI was ill-formed</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-INVALID-VALUE:CAPS">G_BOOKMARK_FILE_ERROR_INVALID_VALUE</para></entry>
<entry role="enum_member_description"><para>a requested field was not found</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-APP-NOT-REGISTERED:CAPS">G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED</para></entry>
<entry role="enum_member_description"><para>a requested application did
not register a bookmark</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-URI-NOT-FOUND:CAPS">G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND</para></entry>
<entry role="enum_member_description"><para>a requested URI was not found</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-READ:CAPS">G_BOOKMARK_FILE_ERROR_READ</para></entry>
<entry role="enum_member_description"><para>document was ill formed</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-UNKNOWN-ENCODING:CAPS">G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING</para></entry>
<entry role="enum_member_description"><para>the text being parsed was
in an unknown encoding</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-WRITE:CAPS">G_BOOKMARK_FILE_ERROR_WRITE</para></entry>
<entry role="enum_member_description"><para>an error occurred while writing</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="G-BOOKMARK-FILE-ERROR-FILE-NOT-FOUND:CAPS">G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND</para></entry>
<entry role="enum_member_description"><para>requested file was not found</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>

</refentry>
