File: list_intro.html

package info (click to toggle)
gridengine 6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 51,532 kB
  • ctags: 51,172
  • sloc: ansic: 418,155; java: 37,080; sh: 22,593; jsp: 7,699; makefile: 5,292; csh: 4,244; xml: 2,901; cpp: 2,086; perl: 1,895; tcl: 1,188; lisp: 669; ruby: 642; yacc: 393; lex: 266
file content (376 lines) | stat: -rw-r--r-- 13,947 bytes parent folder | download | duplicates (3)
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>