aboutsummaryrefslogtreecommitdiff
path: root/src/navigator.h
blob: 06b5c92b91c8d4883f58020b6b49d46e530db863 (plain)
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
#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);

/* 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: */