File: list.h

package info (click to toggle)
prayer 1.3.5-dfsg1-8
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 6,596 kB
  • sloc: ansic: 43,163; makefile: 817; sh: 445; perl: 166
file content (51 lines) | stat: -rw-r--r-- 1,782 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
/* $Cambridge: hermes/src/prayer/lib/list.h,v 1.3 2008/09/16 09:59:57 dpc22 Exp $ */
/************************************************
 *    Prayer - a Webmail Interface              *
 ************************************************/

/* Copyright (c) University of Cambridge 2000 - 2008 */
/* See the file NOTICE for conditions of use and distribution. */

/* Data structures for list class */

struct list_item {
    struct list_item *next;     /* Linked list */
    char *name;                 /* Name of list item, if relevant */
    /* List classes extend here */
};

struct list {
    BOOL use_case;              /* Case is significant in list lookups */
    struct pool *pool;          /* Allocation pool */
    struct list_item *head;     /* Start of list   */
    struct list_item *tail;     /* End of list     */
    unsigned long length;       /* Length of list  */
};

/* Function prototypes for list class */

struct list *list_create(struct pool *pool, BOOL use_case);

void list_free(struct list *list);

void list_unshift(struct list *list, struct list_item *item, char *name);
void list_push(struct list *list, struct list_item *item, char *name);

struct list_item *list_shift(struct list *list);
struct list_item *list_pop(struct list *list);

BOOL
list_insert_sorted(struct list *list, struct list_item *item, char *name);

unsigned long list_length(struct list *list);

struct list_item *list_lookup_byname(struct list *list, char *name);

struct list_item *list_lookup_byoffset(struct list *list,
                                       unsigned long offset);

BOOL list_remove_byname(struct list *list, char *name);

BOOL list_remove_byoffset(struct list *list, unsigned long offset);

BOOL list_rename_item(struct list *list, char *oldname, char *newname);