annotate DynArray.h @ 7:4506c08ed60d
added external, and "AtLeast"
| author |
Me |
| date |
Sat, 20 Nov 2010 08:21:49 +0100 |
| parents |
f4b108f21041 |
| children |
1cffeb870564 |
| rev |
line source |
|
Me@3
|
1 /*
|
|
Me@3
|
2 * File: Vector.h
|
|
Me@3
|
3 * Author: Me
|
|
Me@3
|
4 *
|
|
Me@3
|
5 * Created on May 14, 2010, 3:08 PM
|
|
Me@3
|
6 */
|
|
Me@3
|
7
|
|
Me@4
|
8 #ifndef _DYNARRAY_H
|
|
Me@4
|
9 #define _DYNARRAY_H
|
|
Me@3
|
10
|
|
Me@4
|
11 #include "../VMS_primitive_data_types.h"
|
|
Me@4
|
12
|
|
Me@4
|
13
|
|
Me@4
|
14 //A dynamic array is same as any other array, but add a DynArrayInfo next
|
|
Me@4
|
15 // to it. Accesses and updates of array indexes are done normally, it's
|
|
Me@4
|
16 // only when add a new element into array that use the extra info.
|
|
Me@4
|
17 // An add can cause the pointer to the normal array to change.. so must
|
|
Me@4
|
18 // be protected to single VP at a time.
|
|
Me@3
|
19 typedef struct
|
|
Me@3
|
20 {
|
|
Me@4
|
21 void ***addrOfPtrToArray; //addr of array of ptrs == triple *
|
|
Me@4
|
22 int32 numInArray;
|
|
Me@4
|
23 int32 sizeOfArray;
|
|
Me@3
|
24 }
|
|
Me@6
|
25 PrivDynArrayInfo;
|
|
Me@3
|
26
|
|
Me@6
|
27 PrivDynArrayInfo *
|
|
Me@6
|
28 makePrivDynArrayInfoFrom( void ***addrOfPtrToArray, int32 sizeOfArray );
|
|
Me@3
|
29
|
|
Me@6
|
30 PrivDynArrayInfo *
|
|
Me@6
|
31 makePrivDynArrayOfSize( void ***addrOfPtrToArray, int32 sizeOfArray );
|
|
Me@3
|
32
|
|
Me@7
|
33 PrivDynArrayInfo *
|
|
Me@7
|
34 makePrivDynArrayOfSize_Ext( void ***addrOfPtrToArray, int32 sizeOfArray );
|
|
Me@7
|
35
|
|
Me@4
|
36 int32
|
|
Me@6
|
37 addToDynArray( void *value, PrivDynArrayInfo *info );
|
|
Me@3
|
38
|
|
Me@4
|
39 void
|
|
Me@6
|
40 makeHighestDynArrayIndexBe( PrivDynArrayInfo *info, int32 highestIndex );
|
|
Me@4
|
41
|
|
Me@4
|
42 void
|
|
Me@7
|
43 makeHighestDynArrayIndexBeAtLeast(PrivDynArrayInfo *info,int32 highestIndex);
|
|
Me@7
|
44
|
|
Me@7
|
45 void
|
|
Me@6
|
46 increaseSizeOfDynArrayTo( PrivDynArrayInfo *info, int32 newSize );
|
|
Me@4
|
47
|
|
Me@4
|
48 typedef void (*FreeFnPtr) ( void * ); //fn has to cast void * to whatever
|
|
Me@4
|
49
|
|
Me@4
|
50 void
|
|
Me@6
|
51 freeDynArrayDeep( PrivDynArrayInfo *info, FreeFnPtr freeFnPtr );
|
|
Me@4
|
52
|
|
Me@4
|
53 void
|
|
Me@6
|
54 freeDynArrayFlat( PrivDynArrayInfo *info );
|
|
Me@4
|
55
|
|
Me@4
|
56
|
|
Me@4
|
57 typedef void (*DynArrayFnPtr) ( void * ); //fn has to cast void *
|
|
Me@4
|
58
|
|
Me@4
|
59 void
|
|
Me@6
|
60 forAllInDynArrayDo( PrivDynArrayInfo *info, DynArrayFnPtr fnPtr );
|
|
Me@4
|
61
|
|
Me@4
|
62 #endif /* _DYNARRAY_H */
|
|
Me@4
|
63
|