History of putArray

== Syntax ==

:int putArray (int nr, int x, int y, int z, int val)

== Arguments ==

:nr

::Number of the array. Values from 0 to 99 are acccepted.

:x, y, z

::x, y, and z coordinates of a cell in the array. If you allocated a one-dimensional array, set y and z to zero. If you allocated a two-dimensional array, set z to zero.

:val

::Value that will be stored at the specified coordinates in the array.

== Return ==

:Returns 0 for failure (invalid index nr, or invalid byte-size of Array), and 1 for success.

== Description ==

:Lets you store a value in an array. When storing a value into an Array with byte-size 1, the value will be clamped to the range [0,255]. For an Array of byte-size 2, the value is clamped to [0,65535]. If the byte-size is not 1, 2, or 4, a value of 0 is returned to indicate failure.

== Example ==

:See allocArray

== Also see ==

:allocArray, freeArray, getArray, fgetArray, fputArray, fillArray, ffillArray, getArrayDim, copyArray

== Comments ==

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