[UDF] Fixed Id's Array

[matwachich]

Hello everybody! Here i am with a new, small but usefull UDF.

This UDF is for managing 'special' Arrays:

When adding elements, then deleting elements in the middle, then the last elements's ID are not changed, i mean they are not shifted

You will ask: Why!?

For example: You are managing a TreeView in your program, and you want to associate some data (other than simple numbers, like file paths ...) with the TreeViewItem.

I don't know any function to do that, but all you can do, is associate a simple number with a TreeViewItem (_GuiCtrlTreeView_SetItemParam).

So, you store the data in a simple array, and the id of the data in the array is associated with the TreeViewItem

But there is a problem: when you delete an item, and the array element associated with it, other elements in the array are shifted, and their ID in the array is changed! So, the IDs associated with the TreeViewItem becomes invalid!

But, when using this UDF, you will not have this problem!

Here is the functions list (with calltips)

_FixArray_Create( [ iUBound ] ) Create a Fixed id's Array (required: #include "FixArray.au3")
_FixArray_Destroy( aArray ) Destroy a Fixed id's Array (required: #include "FixArray.au3")
_FixArray_Add( aArray , aValues ) Add a value, or values to a Fixed ID's Array (required: #include "FixArray.au3")
_FixArray_Set( aArray , iId , vNewData , [ iSubItem = 0 ] ) Modify an element's value (required: #include "FixArray.au3")
_FixArray_Get( aArray, iId ) Get the value(s) contained in the Fixed id's Array element Id (required: #include "FixArray.au3")
_FixArray_Del( aArray, iId ) Delete an element of the Fixed id's Array (required: #include "FixArray.au3")
_FixArray_Empty( aArray ) Delete all items in a Fixed id's Array (required: #include "FixArray.au3")
_FixArray_UBound( aArray , [ iOnlyValides ] ) Return the number of elements in the Fixed id's Array (required: #include "FixArray.au3")
_FixArray_IsValid( aArray , iId ) Check an element's validity (have it been deleted) (required: #include "FixArray.au3")

Any comments and suggestions are welcome!!!

PS: this is the only example i have, because it's what i did in my Scite Project Manager (still in developpement)

UDF_FixArray.zip

Important: the guy who downloaded the first archive should redownload, cause i made a mistake and uploaded an outdated version.

Edited February 7, 2012 by matwachich