1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
#ifndef IMV_NAVIGATOR_H
#define IMV_NAVIGATOR_H
#include <unistd.h>
/* Creates an instance of imv_navigator */
struct imv_navigator *imv_navigator_create(void);
/* Cleans up an imv_navigator instance */
void imv_navigator_free(struct imv_navigator *nav);
/* Adds the given path to the navigator's internal list.
* If a directory is given, all files within that directory are added.
* An internal copy of path is made.
* If recursive is non-zero then subdirectories are recursed into.
* Non-zero return code denotes failure. */
int imv_navigator_add(struct imv_navigator *nav, const char *path,
int recursive);
/* Returns a read-only reference to the current path. The pointer is only
* guaranteed to be valid until the next call to an imv_navigator method. */
const char *imv_navigator_selection(struct imv_navigator *nav);
/* Returns the index of the currently selected path */
size_t imv_navigator_index(struct imv_navigator *nav);
/* Change the currently selected path. dir = -1 for previous, 1 for next. */
void imv_navigator_select_rel(struct imv_navigator *nav, ssize_t dir);
/* Change the currently selected path. 0 = first, 1 = second, etc. */
void imv_navigator_select_abs(struct imv_navigator *nav, ssize_t index);
/* Removes the given path. The current selection is updated if necessary,
* based on the last direction the selection moved. */
void imv_navigator_remove(struct imv_navigator *nav, const char *path);
/* Removes the given index. The current selection is updated if necessary,
* based on the last direction the selection moved. */
void imv_navigator_remove_at(struct imv_navigator *nav, size_t index);
/* Removes all paths */
void imv_navigator_remove_all(struct imv_navigator *nav);
/* Return the index of the path given. Returns -1 if not found. */
ssize_t imv_navigator_find_path(struct imv_navigator *nav, const char *path);
/* Returns 1 if either the currently selected path or underlying file has
* changed since last called */
int imv_navigator_poll_changed(struct imv_navigator *nav);
/* Check whether navigator wrapped around paths list */
int imv_navigator_wrapped(struct imv_navigator *nav);
/* Return how many paths in navigator */
size_t imv_navigator_length(struct imv_navigator *nav);
/* Return a path for a given index */
char *imv_navigator_at(struct imv_navigator *nav, size_t index);
#endif
/* vim:set ts=2 sts=2 sw=2 et: */
|
