2 * Copyright (c) 1988, 1989, 1990, 1993
3 * The Regents of the University of California. All rights reserved.
4 * Copyright (c) 1988, 1989 by Adam de Boor
5 * Copyright (c) 1989 by Berkeley Softworks
8 * This code is derived from software contributed to Berkeley by
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 * 3. All advertising materials mentioning features or use of this software
20 * must display the following acknowledgement:
21 * This product includes software developed by the University of
22 * California, Berkeley and its contributors.
23 * 4. Neither the name of the University nor the names of its contributors
24 * may be used to endorse or promote products derived from this software
25 * without specific prior written permission.
27 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
28 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
29 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
30 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
31 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
32 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
33 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
34 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
35 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
36 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
39 * from: @(#)lst.h 8.1 (Berkeley) 6/6/93
40 * $FreeBSD: src/usr.bin/make/lst.h,v 1.9 1999/08/28 01:03:32 peter Exp $
41 * $DragonFly: src/usr.bin/make/lst.h,v 1.11 2004/12/09 19:16:03 okumoto Exp $
46 * Header for using the list library
51 #include <sys/param.h>
56 * Structure of a list node.
59 struct LstNode *prevPtr; /* previous element in list */
60 struct LstNode *nextPtr; /* next in list */
61 int useCount:8; /* Count of functions using the node. Node may not
62 * be deleted until count goes to 0 */
63 int flags:8; /* Node status flags */
64 void *datum; /* datum associated with this element */
66 typedef struct LstNode *LstNode;
69 * Flags required for synchronization
71 #define LN_DELETED 0x0001 /* List node should be removed when done */
74 LstHead, LstMiddle, LstTail, LstUnknown
81 LstNode firstPtr; /* first node in list */
82 LstNode lastPtr; /* last node in list */
83 Boolean isCirc; /* true if the list should be considered
86 * fields for sequential access
88 LstWhere atEnd; /* Where in the list the last access was */
89 Boolean isOpen; /* true if list has been Lst_Open'ed */
90 LstNode curPtr; /* current node, if open. NULL if
92 LstNode prevPtr; /* Previous node, if open. Used by
95 typedef struct Lst *Lst;
97 typedef int CompareProc(void *, void *);
98 typedef int DoProc(void *, void *);
99 typedef void *DuplicateProc(void *);
100 typedef void FreeProc(void *);
103 * NOFREE can be used as the freeProc to Lst_Destroy when the elements are
105 * NOCOPY performs similarly when given as the copyProc to Lst_Duplicate.
107 #define NOFREE ((FreeProc *)NULL)
108 #define NOCOPY ((DuplicateProc *)NULL)
110 #define LST_CONCNEW 0 /* create new LstNode's when using Lst_Concat */
111 #define LST_CONCLINK 1 /* relink LstNode's when using Lst_Concat */
114 * Creation/destruction functions
116 /* Create a new list */
117 Lst Lst_Init(Boolean);
118 /* Duplicate an existing list */
119 Lst Lst_Duplicate(Lst, DuplicateProc *);
120 /* Destroy an old one */
121 void Lst_Destroy(Lst, FreeProc *);
124 * Functions to modify a list
126 /* Insert an element before another */
127 ReturnStatus Lst_Insert(Lst, LstNode, void *);
128 /* Insert an element after another */
129 ReturnStatus Lst_Append(Lst, LstNode, void *);
130 /* Place an element at the front of a lst. */
131 #define Lst_AtFront(LST, D) (Lst_Insert((LST), Lst_First(LST), (D)))
132 /* Place an element at the end of a lst. */
133 #define Lst_AtEnd(LST, D) (Lst_Append((LST), Lst_Last(LST), (D)))
134 /* Remove an element */
135 ReturnStatus Lst_Remove(Lst, LstNode);
136 /* Replace a node with a new value */
137 #define Lst_Replace(NODE, D) (((NODE) == NULL) ? FAILURE : \
138 (((NODE)->datum = (D)), SUCCESS))
139 /* Concatenate two lists */
140 ReturnStatus Lst_Concat(Lst, Lst, int);
143 * Node-specific functions
145 /* Return first element in list */
146 #define Lst_First(LST) ((Lst_Valid(LST) && !Lst_IsEmpty(LST)) \
147 ? (LST)->firstPtr : NULL)
148 /* Return last element in list */
149 #define Lst_Last(LST) ((Lst_Valid(LST) && !Lst_IsEmpty(LST)) \
150 ? (LST)->lastPtr : NULL)
151 /* Return successor to given element */
152 #define Lst_Succ(NODE) (((NODE) == NULL) ? NULL : (NODE)->nextPtr)
153 /* Get datum from LstNode */
154 #define Lst_Datum(NODE) ((NODE)->datum)
157 * Functions for entire lists
159 /* Find an element in a list */
160 #define Lst_Find(LST, D, FN) (Lst_FindFrom((LST), Lst_First(LST), (D), (FN)))
161 /* Find an element starting from somewhere */
162 LstNode Lst_FindFrom(Lst, LstNode, void *, CompareProc *);
164 * See if the given datum is on the list. Returns the LstNode containing
167 LstNode Lst_Member(Lst, void *);
168 /* Apply a function to all elements of a lst */
169 void Lst_ForEach(Lst, DoProc *, void *);
170 #define Lst_ForEach(LST, FN, D) (Lst_ForEachFrom((LST), Lst_First(LST), \
173 * Apply a function to all elements of a lst starting from a certain point.
174 * If the list is circular, the application will wrap around to the
175 * beginning of the list again.
177 void Lst_ForEachFrom(Lst, LstNode, DoProc *, void *);
179 * these functions are for dealing with a list as a table, of sorts.
180 * An idea of the "current element" is kept and used by all the functions
181 * between Lst_Open() and Lst_Close().
184 ReturnStatus Lst_Open(Lst);
185 /* Next element please */
186 LstNode Lst_Next(Lst);
188 Boolean Lst_IsAtEnd(Lst);
189 /* Finish table access */
193 * for using the list as a queue
195 /* Place an element at tail of queue */
196 #define Lst_EnQueue(LST, D) (Lst_Valid(LST) \
197 ? Lst_Append((LST), Lst_Last(LST), (D)) \
199 /* Remove an element from head of queue */
200 void * Lst_DeQueue(Lst);
204 * Return TRUE if the list L is valid
206 #define Lst_Valid(L) (((L) == NULL) ? FALSE : TRUE)
209 * LstNodeValid (LN, L) --
210 * Return TRUE if the LstNode LN is valid with respect to L
212 #define Lst_NodeValid(LN, L) (((LN) == NULL) ? FALSE : TRUE)
216 * TRUE if the list L is empty.
218 #define Lst_IsEmpty(L) (!Lst_Valid(L) || (L)->firstPtr == NULL)