Creates a new empty #GBookmarkFile object.
Adds the application with name and exec to the list of applications that have registered a bookmark for uri into bookmark.
Adds group to the list of groups to which the bookmark for uri belongs to.
Deeply copies a bookmark #GBookmarkFile object to a new one.
Gets the time the bookmark for uri was added to bookmark
Gets the time the bookmark for uri was added to bookmark
Gets the registration information of app_name for the bookmark for uri. See glib.bookmark_file.BookmarkFile.setApplicationInfo for more information about the returned data.
Gets the registration information of app_name for the bookmark for uri. See glib.bookmark_file.BookmarkFile.setApplicationInfo for more information about the returned data.
Retrieves the names of the applications that have registered the bookmark for uri.
Retrieves the description of the bookmark for uri.
Retrieves the list of group names of the bookmark for uri.
Gets the icon of the bookmark for uri.
Gets whether the private flag of the bookmark for uri is set.
Retrieves the MIME type of the resource pointed by uri.
Gets the time when the bookmark for uri was last modified.
Gets the time when the bookmark for uri was last modified.
Gets the number of bookmarks inside bookmark.
Returns the title of the bookmark for uri.
Returns all URIs of the bookmarks in the bookmark file bookmark. The array of returned URIs will be null-terminated, so length may optionally be null.
Gets the time the bookmark for uri was last visited.
Gets the time the bookmark for uri was last visited.
Checks whether the bookmark for uri inside bookmark has been registered by application name.
Checks whether group appears in the list of groups to which the bookmark for uri belongs to.
Looks whether the desktop bookmark has an item with its URI set to uri.
Loads a bookmark file from memory into an empty #GBookmarkFile structure. If the object cannot be created then error is set to a #GBookmarkFileError.
This function looks for a desktop bookmark file named file in the paths returned from glib.global.getUserDataDir and glib.global.getSystemDataDirs, loads the file into bookmark and returns the file's full path in full_path. If the file could not be loaded then error is set to either a #GFileError or #GBookmarkFileError.
Loads a desktop bookmark file into an empty #GBookmarkFile structure. If the file could not be loaded then error is set to either a #GFileError or #GBookmarkFileError.
Changes the URI of a bookmark item from old_uri to new_uri. Any existing bookmark for new_uri will be overwritten. If new_uri is null, then the bookmark is removed.
Removes application registered with name from the list of applications that have registered a bookmark for uri inside bookmark.
Removes group from the list of groups to which the bookmark for uri belongs to.
Removes the bookmark for uri from the bookmark file bookmark.
Sets the time the bookmark for uri was added into bookmark.
Sets the time the bookmark for uri was added into bookmark.
Sets the meta-data of application name inside the list of applications that have registered a bookmark for uri inside bookmark.
Sets the meta-data of application name inside the list of applications that have registered a bookmark for uri inside bookmark.
Sets description as the description of the bookmark for uri.
Sets a list of group names for the item with URI uri. Each previously set group name list is removed.
Sets the icon for the bookmark for uri. If href is null, unsets the currently set icon. href can either be a full URL for the icon file or the icon name following the Icon Naming specification.
Sets the private flag of the bookmark for uri.
Sets mime_type as the MIME type of the bookmark for uri.
Sets the last time the bookmark for uri was last modified.
Sets the last time the bookmark for uri was last modified.
Sets title as the title of the bookmark for uri inside the bookmark file bookmark.
Sets the time the bookmark for uri was last visited.
Sets the time the bookmark for uri was last visited.
This function outputs bookmark as a string.
This function outputs bookmark into a file. The write process is guaranteed to be atomic by using glib.global.fileSetContents internally.
Pointer to the C boxed value
Get the GType of this boxed type.
Boxed GType property.
Convenience method to return this cast to a type. For use in D with statements.
Make a copy of the wrapped C boxed data.
Copy a C boxed value using g_boxed_copy.
Free a C boxed value using g_boxed_free.
glib.bookmark_file.BookmarkFile lets you parse, edit or create files containing bookmarks.
Bookmarks refer to a 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 Desktop Bookmark Specification.
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 <xbel> root element; each bookmark is stored inside a <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 <metadata> element, with its owner attribute set to http://freedesktop.org, 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.
Here is an example of a bookmark file: bookmarks.xbel
A bookmark file might contain more than one bookmark; each bookmark is accessed through its URI.
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 glib.bookmark_file.BookmarkFile.addApplication or glib.bookmark_file.BookmarkFile.setApplicationInfo. If a bookmark has no applications then it won't be dumped when creating the on disk representation, using glib.bookmark_file.BookmarkFile.toData or glib.bookmark_file.BookmarkFile.toFile.