File: lists.h

package info (click to toggle)
moc 1%3A2.6.0~svn-r3005-6
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 2,896 kB
  • sloc: ansic: 31,748; sh: 929; cpp: 487; makefile: 240
file content (52 lines) | stat: -rw-r--r-- 1,719 bytes parent folder | download | duplicates (6)
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
#ifndef LISTS_H
#define LISTS_H

#include "common.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct lists_strs lists_t_strs;
typedef int lists_t_compare (const void *, const void *);

/* List administration functions. */
lists_t_strs *lists_strs_new (int reserve);
void lists_strs_clear (lists_t_strs *list);
void lists_strs_free (lists_t_strs *list);
int lists_strs_size (const lists_t_strs *list);
int lists_strs_capacity (const lists_t_strs *list);
bool lists_strs_empty (const lists_t_strs *list);

/* List member access functions. */
char *lists_strs_at (const lists_t_strs *list, int index);

/* List mutating functions. */
void lists_strs_sort (lists_t_strs *list, lists_t_compare *compare);
void lists_strs_reverse (lists_t_strs *list);

/* Ownership transferring functions. */
void lists_strs_push (lists_t_strs *list, char *s);
char *lists_strs_pop (lists_t_strs *list);
char *lists_strs_swap (lists_t_strs *list, int index, char *s);

/* Ownership preserving functions. */
void lists_strs_append (lists_t_strs *list, const char *s);
void lists_strs_remove (lists_t_strs *list);
void lists_strs_replace (lists_t_strs *list, int index, char *s);

/* Helper functions. */
int lists_strs_split (lists_t_strs *list, const char *s, const char *delim);
int lists_strs_tokenise (lists_t_strs *list, const char *s);
char *lists_strs_fmt (const lists_t_strs *list, const char *fmt);
char *lists_strs_cat (const lists_t_strs *list);
char **lists_strs_save (const lists_t_strs *list);
int lists_strs_load (lists_t_strs *list, const char **saved);
int lists_strs_find (lists_t_strs *list, const char *sought);
bool lists_strs_exists (lists_t_strs *list, const char *sought);

#ifdef __cplusplus
}
#endif

#endif