annotate DynArray.h @ 8:015aab562ace

Nov 14 vers -- Fixed bug in make() where didn't return the info
author Me
date Sun, 14 Nov 2010 11:12:40 -0800
parents f35e64d7a42b
children 4506c08ed60d
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@4 33 int32
Me@6 34 addToDynArray( void *value, PrivDynArrayInfo *info );
Me@3 35
Me@4 36 void
Me@6 37 makeHighestDynArrayIndexBe( PrivDynArrayInfo *info, int32 highestIndex );
Me@4 38
Me@4 39 void
Me@6 40 increaseSizeOfDynArrayTo( PrivDynArrayInfo *info, int32 newSize );
Me@4 41
Me@4 42 typedef void (*FreeFnPtr) ( void * ); //fn has to cast void * to whatever
Me@4 43
Me@4 44 void
Me@6 45 freeDynArrayDeep( PrivDynArrayInfo *info, FreeFnPtr freeFnPtr );
Me@4 46
Me@4 47 void
Me@6 48 freeDynArrayFlat( PrivDynArrayInfo *info );
Me@4 49
Me@4 50
Me@4 51 typedef void (*DynArrayFnPtr) ( void * ); //fn has to cast void *
Me@4 52
Me@4 53 void
Me@6 54 forAllInDynArrayDo( PrivDynArrayInfo *info, DynArrayFnPtr fnPtr );
Me@4 55
Me@4 56 #endif /* _DYNARRAY_H */
Me@4 57