===== Dim (Statement) =====

==== Format ====

=== Create a One Dimensional Array ===

**dim** [[variables|variable]] ( [[integerexpressions|array_size]] )\\
**dim** [[variables|variable]] ( [[integerexpressions|array_size]] ) **fill** [[expressions|expression]]\\
**dim** [[variables|variable]] [ [[integerexpressions|array_size]] ]\\
**dim** [[variables|variable]] [ [[integerexpressions|array_size]] ] **fill** [[expressions|expression]]
=== Create a Two Dimensional Array ===

**dim** [[variables|variable]] (  [[integerexpressions|array_size_rows]] , [[integerexpressions|array_size_columns]])\\
**dim** [[variables|variable]] (  [[integerexpressions|array_size_rows]] , [[integerexpressions|array_size_columns]]) **fill** [[expressions|expression]]\\
**dim** [[variables|variable]] [  [[integerexpressions|array_size_rows]] , [[integerexpressions|array_size_columns]]]\\
**dim** [[variables|variable]] [  [[integerexpressions|array_size_rows]] , [[integerexpressions|array_size_columns]]] **fill** [[expressions|expression]]
=== Use a List to Create and Fill an Array ===

**dim** [[variables|variable]] = [[Lists|{ list ... }]]\\
**dim** [[variables|variable]][] = [[Lists|{ list ... }]]\\
**dim** [[variables|variable]] = [[Lists|{ { list ... }, { list ... } ... }]]\\
**dim** [[variables|variable]][] = [[Lists|{ { list ... }, { list ... } ... }]]

=== Copy One Array to Another ===

**dim** [[variables|variable]] = [[variables|variable]][]\\
**dim** [[variables|variable]][] = [[variables|variable]][]

=== Fill an Existing Array With a Single Value ===

**dim** [[variables|variable]] **fill** [[expressions|expression]]\\
**dim** [[variables|variable]][] **fill** [[expressions|expression]]

==== Description ====

Returns a newly created single dimensional array of length //integer// or a 2 dimensional array that can be addressed by //row// and //column//.  By default the elements in the array are left uninitialized (empty), You may add the fill option to fill all elements with a single value.\\

The first element of an array has an index of 0 (zero).  Indexes range from 0 to length-1.

The **dim** statement can also be used to create a new array that is a duplicate of another array.  The form "DIM var = var" does this by dimensioning a new array in memory and copying all of the data from the original array.

==== Example ====

<code>
dim z = {1, 2, 3, 4, 5}
print z[0] + " " + z[4]
</code>
will print
<code>
1 5
</code>

==== Example Two ====
<code>
dim c(4)
c[0] = "cow"
c[1] = "brown"
c[2] = "how"
c[3] = "now"
print c[2] + " " + c[3] + " ";
print c[1] + " " + c[0] + "?"
</code>
will print
<code>
how now brown cow?
</code>

==== See Also ====
{{page>en:start#Arrays and Variables&noheader}}

==== History ==== 
|1.99.99.55|Cleaned up documentation and added array copy.|
|1.99.99.56|Added fill clause|
|1.99.99.57|Added additional fill options|
|1.99.99.72|added the [] when setting one array from another|