Warning
You're browsing the old v2.x documentation. This version is no longer maintained. Click here to go the v3.x documentation.
DATA
Syntax:
data varname[] = <value1>, <value2>, <value3>, ...
Or in combination with the INCBIN directive:
data varname![] = incbin "path/to/binary_file"
The DATA
directive allocates a one-dimensional static array in memory filled with pre-initialized data in compile time. The length of the array will equal to the number of elements in the list of values. Values can be of any type, but this type must match the type of the variable.
If the right-hand side of the assignment is an INCBIN
directive, the length of the array will equal to the length of the file and each byte in the file will become one array element. Only byte type arrays can be initialized this way.
Example with value list:
rem -- this will print: 9 data squares[] = 0, 1, 4, 9, 16 print squares[3]
Example with INCBIN
:
rem -- load a sprite data sprite![] = incbin "sprite.bin"
DATA
statements can be written anywhere in your program. The following will also work:
print squares[3] end rem ** program data ** data squares[] = 0, 1, 4, 9, 16
The data members can be updated in runtime using the LET
command:
rem ** this will print 9 first, then -1 ** print squares[3] let squares[3] = -1 print squares[3] end rem ** program data ** data squares[] = 0, 1, 4, 9, 16
Again, note there is no runtime array bounds checking. Trying to write data over the array bounds may break the program.