mirror of
https://git.pwmt.org/pwmt/zathura.git
synced 2025-01-01 10:36:00 +01:00
document database functions
This commit is contained in:
parent
7b3d31a3e5
commit
390061c896
1 changed files with 29 additions and 0 deletions
29
database.h
29
database.h
|
@ -9,14 +9,43 @@
|
||||||
#include "zathura.h"
|
#include "zathura.h"
|
||||||
#include "bookmarks.h"
|
#include "bookmarks.h"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Initialize database system.
|
||||||
|
* @param path Path to the database file.
|
||||||
|
* @return A valid zathura_database_t instance or NULL on failure
|
||||||
|
*/
|
||||||
zathura_database_t* zathura_db_init(const char* path);
|
zathura_database_t* zathura_db_init(const char* path);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Free database instance.
|
||||||
|
* @param The database instance to free.
|
||||||
|
*/
|
||||||
void zathura_db_free(zathura_database_t* db);
|
void zathura_db_free(zathura_database_t* db);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add or update bookmark in the database.
|
||||||
|
* @param db The database instance
|
||||||
|
* @param file The file to which the bookmark belongs to.
|
||||||
|
* @param bookmark The bookmark instance.
|
||||||
|
* @return true on success, false otherwise
|
||||||
|
*/
|
||||||
bool zathura_db_add_bookmark(zathura_database_t* db, const char* file, zathura_bookmark_t* bookmark);
|
bool zathura_db_add_bookmark(zathura_database_t* db, const char* file, zathura_bookmark_t* bookmark);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add or update bookmark in the database.
|
||||||
|
* @param db The database instance
|
||||||
|
* @param file The file to which the bookmark belongs to.
|
||||||
|
* @param bookmark The bookmark instance.
|
||||||
|
* @return true on success, false otherwise
|
||||||
|
*/
|
||||||
bool zathura_db_remove_bookmark(zathura_database_t* db, const char* file, const char* id);
|
bool zathura_db_remove_bookmark(zathura_database_t* db, const char* file, const char* id);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Loads all bookmarks from the database belonging to a specific file.
|
||||||
|
* @param db The database instance.
|
||||||
|
* @param file The file for which the bookmarks should be loaded.
|
||||||
|
* @return List of zathura_bookmark_t* or NULL on failure.
|
||||||
|
*/
|
||||||
girara_list_t* zathura_db_load_bookmarks(zathura_database_t* db, const char* file);
|
girara_list_t* zathura_db_load_bookmarks(zathura_database_t* db, const char* file);
|
||||||
|
|
||||||
#endif // DATABASE_H
|
#endif // DATABASE_H
|
||||||
|
|
Loading…
Reference in a new issue