This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:arrays [2016/05/28 03:24] junior-root |
en:arrays [2020/04/21 18:29] (current) admin |
||
---|---|---|---|
Line 1: | Line 1: | ||
===== Arrays ===== | ===== Arrays ===== | ||
Arrays are allocated using the [[DIM|DIM]] command or re-sized using [[REDIM|REDIM]]. | Arrays are allocated using the [[DIM|DIM]] command or re-sized using [[REDIM|REDIM]]. | ||
- | Array sizes may also be extracted using [?] [?,] and [,?] on the end of the array variable. | + | [[arraylength|Array lengths]] |
- | ==== Example | + | |
+ | By default arrays may be indexed using an integer in the range of 0 to array_length-1. | ||
+ | |||
+ | ==== Assigning values to an array ==== | ||
+ | |||
+ | Values may be assigned to an array in one of five ways: | ||
+ | |||
+ | 1. By using the [[dim|Dim]] statement to reserve space for the array in the computer' | ||
< | < | ||
- | print myarray[4] | + | dim a(10) |
+ | for t = 0 to a[?]-1 | ||
+ | a[t] = t | ||
+ | next t | ||
</ | </ | ||
- | will display on the screen the fifth element in ' | ||
+ | 2. By using a [[lists|list]] to create and assign an array. | ||
+ | < | ||
+ | a = {{0, | ||
+ | </ | ||
+ | or | ||
+ | < | ||
+ | b[] = {1,2,3,4} | ||
+ | </ | ||
+ | |||
+ | 3. By using the [[dim|Dim]] statement to copy an existing array into another array. | ||
+ | < | ||
+ | a = {1,2,3,4} | ||
+ | dim b = a[] | ||
+ | </ | ||
+ | |||
+ | 4. By using the [[explode|Explode]] or [[explodex|Explodex]] functions to split a string into an array. | ||
+ | < | ||
+ | a = explode(" | ||
+ | </ | ||
+ | |||
+ | 5. Using the [[fill|fill]] assignment operator (with or without [[dim|dim]]) | ||
+ | < | ||
+ | dim c fill " | ||
+ | dim e[] fill 0 | ||
+ | b fill "" | ||
+ | a[] fill -1 | ||
+ | </ | ||
+ | |||
+ | ==== Passing Arrays of Data to Builtin Functions and Statements ==== | ||
+ | |||
+ | When passing an array of data, like to the [[sound|sound]] statement, you may include an empty set of brackets [] after the variable name. This was added to reduce the confusion between a regular variable and a variable containing an array of values. | ||
+ | |||
+ | ==== History ==== | ||
+ | |1.99.99.55|added dim logic to copy one array to another| | ||
+ | |1.99.99.57|added the fill assignment operator| | ||
+ | |1.99.99.72|added the array passing note| | ||
+ | |2.0.0.0|Added ability to change array base| |