Line data Source code
1 : /*-------------------------------------------------------------------------
2 : *
3 : * Simple list facilities for frontend code
4 : *
5 : * Data structures for simple lists of OIDs and strings. The support for
6 : * these is very primitive compared to the backend's List facilities, but
7 : * it's all we need in, eg, pg_dump.
8 : *
9 : *
10 : * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
11 : * Portions Copyright (c) 1994, Regents of the University of California
12 : *
13 : * src/fe_utils/simple_list.c
14 : *
15 : *-------------------------------------------------------------------------
16 : */
17 : #include "postgres_fe.h"
18 :
19 : #include "fe_utils/simple_list.h"
20 :
21 :
22 : /*
23 : * Append an OID to the list.
24 : */
25 : void
26 71 : simple_oid_list_append(SimpleOidList *list, Oid val)
27 : {
28 : SimpleOidListCell *cell;
29 :
30 71 : cell = pg_malloc_object(SimpleOidListCell);
31 71 : cell->next = NULL;
32 71 : cell->val = val;
33 :
34 71 : if (list->tail)
35 24 : list->tail->next = cell;
36 : else
37 47 : list->head = cell;
38 71 : list->tail = cell;
39 71 : }
40 :
41 : /*
42 : * Is OID present in the list?
43 : */
44 : bool
45 43098 : simple_oid_list_member(SimpleOidList *list, Oid val)
46 : {
47 : SimpleOidListCell *cell;
48 :
49 51472 : for (cell = list->head; cell; cell = cell->next)
50 : {
51 8441 : if (cell->val == val)
52 67 : return true;
53 : }
54 43031 : return false;
55 : }
56 :
57 : /*
58 : * Append a string to the list.
59 : *
60 : * The given string is copied, so it need not survive past the call.
61 : */
62 : void
63 7154 : simple_string_list_append(SimpleStringList *list, const char *val)
64 : {
65 : SimpleStringListCell *cell;
66 :
67 : cell = (SimpleStringListCell *)
68 7154 : pg_malloc(offsetof(SimpleStringListCell, val) + strlen(val) + 1);
69 :
70 7154 : cell->next = NULL;
71 7154 : cell->touched = false;
72 7154 : strcpy(cell->val, val);
73 :
74 7154 : if (list->tail)
75 6724 : list->tail->next = cell;
76 : else
77 430 : list->head = cell;
78 7154 : list->tail = cell;
79 7154 : }
80 :
81 : /*
82 : * Is string present in the list?
83 : *
84 : * If found, the "touched" field of the first match is set true.
85 : */
86 : bool
87 918 : simple_string_list_member(SimpleStringList *list, const char *val)
88 : {
89 : SimpleStringListCell *cell;
90 :
91 1251 : for (cell = list->head; cell; cell = cell->next)
92 : {
93 865 : if (strcmp(cell->val, val) == 0)
94 : {
95 532 : cell->touched = true;
96 532 : return true;
97 : }
98 : }
99 386 : return false;
100 : }
101 :
102 : /*
103 : * Destroy an OID list
104 : */
105 : void
106 1 : simple_oid_list_destroy(SimpleOidList *list)
107 : {
108 : SimpleOidListCell *cell;
109 :
110 1 : cell = list->head;
111 5 : while (cell != NULL)
112 : {
113 : SimpleOidListCell *next;
114 :
115 4 : next = cell->next;
116 4 : pg_free(cell);
117 4 : cell = next;
118 : }
119 1 : }
120 :
121 : /*
122 : * Destroy a string list
123 : */
124 : void
125 136 : simple_string_list_destroy(SimpleStringList *list)
126 : {
127 : SimpleStringListCell *cell;
128 :
129 136 : cell = list->head;
130 6462 : while (cell != NULL)
131 : {
132 : SimpleStringListCell *next;
133 :
134 6326 : next = cell->next;
135 6326 : pg_free(cell);
136 6326 : cell = next;
137 : }
138 136 : }
139 :
140 : /*
141 : * Find first not-touched list entry, if there is one.
142 : */
143 : const char *
144 0 : simple_string_list_not_touched(SimpleStringList *list)
145 : {
146 : SimpleStringListCell *cell;
147 :
148 0 : for (cell = list->head; cell; cell = cell->next)
149 : {
150 0 : if (!cell->touched)
151 0 : return cell->val;
152 : }
153 0 : return NULL;
154 : }
155 :
156 : /*
157 : * Append a pointer to the list.
158 : *
159 : * Caller must ensure that the pointer remains valid.
160 : */
161 : void
162 9149 : simple_ptr_list_append(SimplePtrList *list, void *ptr)
163 : {
164 : SimplePtrListCell *cell;
165 :
166 9149 : cell = pg_malloc_object(SimplePtrListCell);
167 9149 : cell->next = NULL;
168 9149 : cell->ptr = ptr;
169 :
170 9149 : if (list->tail)
171 8691 : list->tail->next = cell;
172 : else
173 458 : list->head = cell;
174 9149 : list->tail = cell;
175 9149 : }
176 :
177 : /*
178 : * Destroy only pointer list and not the pointed-to element
179 : */
180 : void
181 23 : simple_ptr_list_destroy(SimplePtrList *list)
182 : {
183 : SimplePtrListCell *cell;
184 :
185 23 : cell = list->head;
186 55 : while (cell != NULL)
187 : {
188 : SimplePtrListCell *next;
189 :
190 32 : next = cell->next;
191 32 : pg_free(cell);
192 32 : cell = next;
193 : }
194 23 : }
|