Older Newer
Sun, 25 May 2008 08:43:23 . . . . afh [typo]


Changes by last author:

Added:
= fillArray =

== Syntax ==

:bool fillArray (int nr, int val)

== Arguments ==

:nr

::Number of the Array. Values from 0 to 99 are allowed.

:val

::Value to fill array

== Return ==

Returns true if successful, or false if an error occurred (e.g., incorrect value for nr or byte-size of Array).

== Description ==

Function for filling an array with a certain byte, short, integer, or double value, e.g. for initializing all cells of the array to zero. If the byte-size of the Array is 1, 2, or 4, then val is converted to an 8-bit, 16-bit, or 32-bit integer as needed. If the byte-size of the Array is 8, then val is converted to a 64-bit (double)? floating-point value (not a 64-bit integer!) for storage in the Array.

== Example ==

<code>

%ffp

OnFilterStart:{

allocArray (0,100,0,0,1);

fillArray (0, 112);

Info ("The array was filled with the value: %d", getArray(0, rnd(0,99) ,0,0) );

freeArray(0);

return false;

}

</code>

== Also see ==

:ffillArray, allocArray, freeArray, getArray, putArray, getArrayDim, copyArray

== Comments ==

:Note that the use of fillArray to store a 64-bit floating-point value in the Array is depecrated; use ffillArray instead.

<code>

</code>

:Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.