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
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
|
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
Grid Engine List Library - a library providing generic list
functionality and database like list management
DESCRIPTION
The Grid Engine List Library provides the functionality of a
generic list. This means the list functions are applicable
to every list based on a number of certain basic types. List
definitions are extensible on a per program basis as long as
the old fields remain in the list definition.
LIBRARY FUNCTIONS
The list library provides the following functions. These are
explained in detail in the stated man pages.
LIST FUNCTIONS
<B><A HREF="../htmlman3/lCreateList.html">lCreateList(3)</A></B>
create a generic list
<B><A HREF="../htmlman3/lCreateElemList.html">lCreateElemList(3)</A></B>
create a generic list with a certain number of empty
elements
<B><A HREF="../htmlman3/lFreeList.html">lFreeList(3)</A></B>
free the memory allocated for a generic list and all
its sub-lists
<B><A HREF="../htmlman3/lCopyList.html">lCopyList(3)</A></B>
copy a generic list with all its sub-lists and strings
<B><A HREF="../htmlman3/lAddList.html">lAddList(3)</A></B>
concatenate two generic lists
<B><A HREF="../htmlman3/lSortList.html">lSortList(3)</A></B>
sort a generic list
<B><A HREF="../htmlman3/lDumpList.html">lDumpList(3)</A></B>
dump a generic list to file
<B><A HREF="../htmlman3/lUndumpList.html">lUndumpList(3)</A></B>
undump a generic list with all its data from file
<B><A HREF="../htmlman3/lWriteList.html">lWriteList(3)</A></B>
write a generic list to stdout
<B><A HREF="../htmlman3/lGetListName.html">lGetListName(3)</A></B>
return the name of a generic list
<B><A HREF="../htmlman3/lGetListDescr.html">lGetListDescr(3)</A></B>
return a pointer to the descriptor of a generic list
<B><A HREF="../htmlman3/lGetNumberOfElem.html">lGetNumberOfElem(3)</A></B>
return the number of list elements contained in a gen-
eric list
<B><A HREF="../htmlman3/lGetNumberOfRemainingElem.html">lGetNumberOfRemainingElem(3)</A></B>
return the number of list elements contained in the
remainder of a generic list after a specified list ele-
ment
LIST ELEMENT FUNCTIONS
<B><A HREF="../htmlman3/lCreateElem.html">lCreateElem(3)</A></B>
create a generic list element
<B><A HREF="../htmlman3/lFreeElem.html">lFreeElem(3)</A></B>
frees the memory allocated for a generic list element,
its strings and its sub-lists
<B><A HREF="../htmlman3/lCopyElem.html">lCopyElem(3)</A></B>
duplicate a list element with all its sub-lists and
strings
<B><A HREF="../htmlman3/lAppendElem.html">lAppendElem(3)</A></B>
append a list element to an existing list
<B><A HREF="../htmlman3/lInsertElem.html">lInsertElem(3)</A></B>
insert a list element into an existing list after a
specified element
<B><A HREF="../htmlman3/lDechainElem.html">lDechainElem(3)</A></B>
dechain a list element from a list, the dechained ele-
ment is not freed
<B><A HREF="../htmlman3/lFirst.html">lFirst(3)</A></B>
get the first list element
<B><A HREF="../htmlman3/lLast.html">lLast(3)</A></B>
get the last list element
<B><A HREF="../htmlman3/lNext.html">lNext(3)</A></B>
get the successor of the list element
<B><A HREF="../htmlman3/lPrev.html">lPrev(3)</A></B>
get the predecessor of the list element
<B><A HREF="../htmlman3/lFindFirst.html">lFindFirst(3)</A></B>
find the first list element matching specified condi-
tions
<B><A HREF="../htmlman3/lFindLast.html">lFindLast(3)</A></B>
find the last list element matching specified condi-
tions
<B><A HREF="../htmlman3/lFindNext.html">lFindNext(3)</A></B>
find the next list element starting at a certain list
element matching specified conditions
<B><A HREF="../htmlman3/lFindPrev.html">lFindPrev(3)</A></B>
find the previous list element starting at a certain
list element matching specified conditions
<B><A HREF="../htmlman3/lDumpElem.html">lDumpElem(3)</A></B>
dump a list element to file
<B><A HREF="../htmlman3/lUndumpElem.html">lUndumpElem(3)</A></B>
undump a list element from file into memory
<B><A HREF="../htmlman3/lWriteElem.html">lWriteElem(3)</A></B>
write a list element to stdout
<B><A HREF="../htmlman3/lGetPosViaElem.html">lGetPosViaElem(3)</A></B>
get the field position of a list element field with
name 'nm'
FIELD ACCESS FUNCTIONS
<B><A HREF="../htmlman3/lGetInt.html">lGetInt(3)</A></B>
<B><A HREF="../htmlman3/lGetUlong.html">lGetUlong(3)</A></B>
<B><A HREF="../htmlman3/lGetString.html">lGetString(3)</A></B>
<B><A HREF="../htmlman3/lGetList.html">lGetList(3)</A></B>
<B><A HREF="../htmlman3/lGetFloat.html">lGetFloat(3)</A></B>
<B><A HREF="../htmlman3/lGetDouble.html">lGetDouble(3)</A></B>
<B><A HREF="../htmlman3/lGetChar.html">lGetChar(3)</A></B>
<B><A HREF="../htmlman3/lGetLong.html">lGetLong(3)</A></B>
get the value of the specified type from a list element
field; the element and the field name are delivered as
arguments
<B><A HREF="../htmlman3/lSetInt.html">lSetInt(3)</A></B>
<B><A HREF="../htmlman3/lSetUlong.html">lSetUlong(3)</A></B>
<B><A HREF="../htmlman3/lSetString.html">lSetString(3)</A></B>
<B><A HREF="../htmlman3/lSetList.html">lSetList(3)</A></B>
<B><A HREF="../htmlman3/lSetFloat.html">lSetFloat(3)</A></B>
<B><A HREF="../htmlman3/lSetDouble.html">lSetDouble(3)</A></B>
<B><A HREF="../htmlman3/lSetChar.html">lSetChar(3)</A></B>
<B><A HREF="../htmlman3/lSetLong.html">lSetLong(3)</A></B>
set the value of the specified type in a corresponding
list element field; the element, the field name and a
new value are delivered as arguments
<B><A HREF="../htmlman3/lGetPosInt.html">lGetPosInt(3)</A></B>
<B><A HREF="../htmlman3/lGetPosUlong.html">lGetPosUlong(3)</A></B>
<B><A HREF="../htmlman3/lGetPosString.html">lGetPosString(3)</A></B>
<B><A HREF="../htmlman3/lGetPosList.html">lGetPosList(3)</A></B>
<B><A HREF="../htmlman3/lGetPosFloat.html">lGetPosFloat(3)</A></B>
<B><A HREF="../htmlman3/lGetPosDouble.html">lGetPosDouble(3)</A></B>
<B><A HREF="../htmlman3/lGetPosChar.html">lGetPosChar(3)</A></B>
<B><A HREF="../htmlman3/lGetPosLong.html">lGetPosLong(3)</A></B>
get the value of the specified type in a corresponding
list element field; the element and the field position
are delivered as arguments
<B><A HREF="../htmlman3/lSetPosInt.html">lSetPosInt(3)</A></B>
<B><A HREF="../htmlman3/lSetPosUlong.html">lSetPosUlong(3)</A></B>
<B><A HREF="../htmlman3/lSetPosString.html">lSetPosString(3)</A></B>
<B><A HREF="../htmlman3/lSetPosList.html">lSetPosList(3)</A></B>
<B><A HREF="../htmlman3/lSetPosFloat.html">lSetPosFloat(3)</A></B>
<B><A HREF="../htmlman3/lSetPosDouble.html">lSetPosDouble(3)</A></B>
<B><A HREF="../htmlman3/lSetPosChar.html">lSetPosChar(3)</A></B>
<B><A HREF="../htmlman3/lSetPosLong.html">lSetPosLong(3)</A></B>
set the value of the specified type in a corresponding
list element field; the element, the field position and
the new value are delivered as arguments
LIST DESCRIPTOR FUNCTIONS
<B><A HREF="../htmlman3/lInit.html">lInit(3)</A></B>
initialize the name to string conversion
<B><A HREF="../htmlman3/lNm2Str.html">lNm2Str(3)</A></B>
convert an int value specifying a field name to its
corresponding name string
<B><A HREF="../htmlman3/_lNm2Str.html">_lNm2Str(3)</A></B>
convert an int value specifying a field name to its
corresponding name string using a specified name space
<B><A HREF="../htmlman3/lStr2Nm.html">lStr2Nm(3)</A></B>
convert a field name to its corresponding field id
<B><A HREF="../htmlman3/_lStr2Nm.html">_lStr2Nm(3)</A></B>
convert a field name to its corresponding field id
using a specified name space
<B><A HREF="../htmlman3/lCountDescr.html">lCountDescr(3)</A></B>
get the number of fields of a descriptor
<B><A HREF="../htmlman3/lGetPosInDescr.html">lGetPosInDescr(3)</A></B>
get the position of the field named 'nm' from the
descriptor
<B><A HREF="../htmlman3/lDumpDescr.html">lDumpDescr(3)</A></B>
dump a list descriptor to a file
<B><A HREF="../htmlman3/lUndumpDescr.html">lUndumpDescr(3)</A></B>
undump a list descriptor from a file to memory
<B><A HREF="../htmlman3/lWriteDescr.html">lWriteDescr(3)</A></B>
write a descriptor to stdout
LIST DATABASE FUNCTIONS
<B><A HREF="../htmlman3/lSelect.html">lSelect(3)</A></B>
select returns a list of elements that match the speci-
fied conditions.
<B><A HREF="../htmlman3/lSelectDestroy.html">lSelectDestroy(3)</A></B>
select reduces a list to those elements matching the
specified conditions.
<B><A HREF="../htmlman3/lSplit.html">lSplit(3)</A></B>
splits a list into two parts. One part contains all
elements fulfilling the specified condition the other
part contains the elements not fulfilling the condi-
tion.
<B><A HREF="../htmlman3/lJoinSublist.html">lJoinSublist(3)</A></B>
join a specified list with one of its sub-lists; one
can specify conditions for the list and the sub-list.
The joined list is returned and the original list is
unchanged.
<B><A HREF="../htmlman3/lJoin.html">lJoin(3)</A></B>
join two lists which fulfill the specified conditions
to a new list that contains the enumerated fields. The
joined list is returned and the original lists are
unaltered.
<B><A HREF="../htmlman3/lWhere.html">lWhere(3)</A></B>
build a lCondition data structure which is used as con-
dition for various functions as lSelect or lJoin
<B><A HREF="../htmlman3/_lWhere.html">_lWhere(3)</A></B>
build a lCondition data structure which is used as con-
dition for various functions as lSelect or lJoin
<B><A HREF="../htmlman3/lOrWhere.html">lOrWhere(3)</A></B>
build a lCondition data structure composed of two con-
ditions connected by logical or
<B><A HREF="../htmlman3/lAndWhere.html">lAndWhere(3)</A></B>
build a lCondition data structure composed of two con-
ditions connected by logical and
<B><A HREF="../htmlman3/lFreeWhere.html">lFreeWhere(3)</A></B>
free a lCondition data structure
<B><A HREF="../htmlman3/lWriteWhere.html">lWriteWhere(3)</A></B>
write a lCondition data structure to stdout
<B><A HREF="../htmlman3/lWhat.html">lWhat(3)</A></B>
build a lEnumeration data structure which is used to
specify the fields that are contained in a newly
created list element
<B><A HREF="../htmlman3/lFreeWhat.html">lFreeWhat(3)</A></B>
free a lEnumeration data structure
<B><A HREF="../htmlman3/lWriteWhat.html">lWriteWhat(3)</A></B>
write a lEnumeration data structure to stdout
<B><A HREF="../htmlman3/lCountWhat.html">lCountWhat(3)</A></B>
count the number of fields in a lEnumeration data
structure
DATA STRUCTURES
The following essential data structures are used by the
various list library functions.
lDescr *descriptor
The descriptor contains the information which fields
(name, type) are contained in a list.
lList *list
The lList pointer specifies a list created by lCreateL-
ist or any of the other functions generating a list.
Here the name of the list, a reference to the descrip-
tor, the number of contained list elements and a refer-
ence to the first and last list element are stored.
lListElem *list_element
The lListElem pointer is returned on creation of a new
list element and contains the actual data.
lCondition *conditions
The lCondition pointer is a representation of logically
connected compare operations. It serves to decide
whether it should be operated on a special list ele-
ment.
lEnumeration *field_enumerations
The lEnumeration pointer specifies which fields of a
given list element shall be involved in a specified
action. It is possible under certain circumstances to
specify all fields or no field at all.
lSortOrder *sorting_order
The lSortOrder pointer is used to specify sorting cri-
teria for a generic list. It is possible to declare
combined sorting keys.
SEE ALSO
<B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>.
COPYRIGHT
See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and permis-
sions.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|
