File: list.hh

package info (click to toggle)
abacus 0.9.13-4
  • links: PTS
  • area: main
  • in suites: potato
  • size: 6,308 kB
  • ctags: 5,120
  • sloc: ansic: 27,540; cpp: 11,426; tcl: 7,564; makefile: 386; yacc: 327; lex: 265; sh: 221
file content (124 lines) | stat: -rw-r--r-- 3,477 bytes parent folder | download | duplicates (2)
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
/* $Id: list.hh,v 1.2 1998/09/07 19:33:04 cthulhu Exp $ */

#ifndef LIST_HH
#define LIST_HH

#define UINT unsigned int

template <class T> class Lista;

template <class ElemType>
class Node {
public:
  int IsFirst();
  /* Checks if current element is first in list */
  int IsLast();
  /* Checks if current element is last in list */
private:
  ElemType *element;
  Node *next;
  Node *prev;
  friend class Lista<ElemType>;
};

template <class ElemType>
class Lista {
private:
  UINT num_elements;
  Node<ElemType> *head;
  Node<ElemType> *tail;

public:
  Lista();
  /* Construct an empty list of void pointers.
     Returns new list. */
  
  ~Lista() { RemoveAll(); }
  /* Removes list and any elements left in it. 
     The elements are only removed from the list, not freed. */
  
  ElemType* GetHead();
  ElemType* GetTail();
  /* Returns first/last element of list. 
     If the list is empty the result is undefined. IsEmpty() is recomended. */

  ElemType* RemoveHead();
  ElemType* RemoveTail();
  /* Removes and returns first/last element from list.
     If the list is empty the result is undefined. IsEmpty() is recomended. */
  
  Node<ElemType>* AddHead(ElemType*);
  Node<ElemType>* AddTail(ElemType*);
  /* Adds an element to head/tail of list.
     Returns the position of the added element. 
     On error returns NULL. */

  void RemoveAll();
  /* Removes all elements from list. The elements are not freed. */

  Node<ElemType>* GetHeadPosition();
  Node<ElemType>* GetTailPosition();
  /* Returns the position of the first/last element of list. */

  ElemType* GetNext(Node<ElemType>**);
  ElemType* GetPrev(Node<ElemType>**);
  /* Returns the element of the given position and updates it
     to the next/previous element. The new position is NULL if
     the position given was the last/first element of list .*/

  ElemType* GetAt(Node<ElemType>*);
  /* Returns the element at given position. */

  ElemType* SetAt(Node<ElemType>*, ElemType*);
  /* Puts an element at the given position and
     Returns the element previous located at that position. */
  
  ElemType* RemoveAt(Node<ElemType>*);
  /* Removes the element at the given position and returns it. */

  Node<ElemType>* InsertBefore(Node<ElemType>*, ElemType*);
  Node<ElemType>* InsertAfter(Node<ElemType>*, ElemType*);
  /* Inserts an element before/after a given position.
     Returns the position of the new element. 
     On error returns NULL. */

  void MergeList (Lista<ElemType> list2);
  /* Merges this list with list2. list2 becomes invalid. */

  Node<ElemType>* Find(ElemType*);
  /* Returns the position of the element given. 
     If not found returns NULL. */

  Node<ElemType>* FindIndex(UINT);
  /* Returns the position of an element specified by a zero-based index. */

  UINT GetCount();
  /* Returns the number of elements in list. */

  int IsEmpty();
  /* Checks if the list is empty. */

  ElemType* GetAtIndex(UINT index) {
    GetAt (FindIndex(index));
  }
  
  Node<ElemType>* InsBefIndex(UINT index, ElemType* elem) {
    InsertBefore (FindIndex(index), elem);
  }

  Node<ElemType>* InsAftIndex(UINT index, ElemType* elem) {
    InsertAfter (FindIndex(index), elem);
  }
};

#endif

/* $Log: list.hh,v $
 * Revision 1.2  1998/09/07 19:33:04  cthulhu
 * Added forward declaration:
 * 	template <class T> class Lista;
 * seems people were having trouble without it with the egcs compiler.
 *
 * Revision 1.1  1998/08/17 20:23:26  cthulhu
 * Initial revision
 * */