====== Array ======

An Array is a collection of values. You can use the [[editor:blocks:variables:set-array|Set Array]] command to store values in the array.\\
You can describe an Array in the following way\\
{{:editor:blocks:variables:1d_array_example.png|}}\\

Let's say you want to create an Array with the values of "one", "two" and "three". You can do it in the following way\\
{{:editor:blocks:variables:array.png|}}

In order to access the array values, you need to use the [] syntax. \\
<color #ed1c24>arr1[0]</color> value is <color #00a2e8>"one"</color>\\
<color #ed1c24>arr1[1]</color> value is <color #00a2e8>"tow"</color>\\
<color #ed1c24>arr1[2]</color> value is <color #00a2e8>"three"</color>\\

In order to know the Array length, you can use ".length" syntax.\\
<color #ed1c24>arr1.length</color> is <color #00a2e8>3</color>\\

Here is an example of iterating through the arr1 array values and display them in a [[editor:blocks:2d-models:label|Label]]\\
{{:editor:blocks:variables:array_example1.png|}}\\
http://www.gamemaker3d.com/player?pid=01615828

===== 2D Array =====
A two-dimensional Array is a collection of Arrays. It means that every value in the array is an Array itself.\\
You can describe a 2D Array in the following way\\
{{:editor:blocks:variables:2d_array_example.png|}}\\

You can use the [[editor:blocks:variables:set-array|Set Array]] command to store values in the a 2D Array by using the x,y parameters as the cell position in the array.\\
You will need to set the following x,y position in order to build the above array\\
<color #ed1c24>x=1, y=1</color> value = <color #00a2e8>"a"</color>\\
<color #ed1c24>x=2, y=1</color> value = <color #00a2e8>"b"</color>\\
<color #ed1c24>x=3, y=1</color> value = <color #00a2e8>"c"</color>\\
<color #ed1c24>x=1, y=2</color> value = <color #00a2e8>"d"</color>\\
<color #ed1c24>x=2, y=2</color> value = <color #00a2e8>"e"</color>\\
<color #ed1c24>x=3, y=2</color> value = <color #00a2e8>"f"</color>\\
<color #ed1c24>x=1, y=3</color> value = <color #00a2e8>"g"</color>\\
<color #ed1c24>x=2, y=3</color> value = <color #00a2e8>"h"</color>\\
<color #ed1c24>x=3, y=3</color> value = <color #00a2e8>"i"</color>\\

You can use the [[editor:blocks:animation:for|For]] command to build an array and set its values.\\
Here is an example of building a 2D Array with the multiplication table\\
{{:editor:blocks:variables:2d_array_set_example.png|}}\\
http://www.gamemaker3d.com/player?pid=01615844

You can use the [][] syntax to access the 2D Array values\\
<color #ed1c24>arr1[0][0]</color> value is <color #00a2e8>0</color>\\
<color #ed1c24>arr1[5][4]</color> value is <color #00a2e8>20</color>\\
<color #ed1c24>arr1[3][5]</color> value is <color #00a2e8>15</color>\\
.\\
.\\
.\\

{{ :editor:blocks:info-148099_960_720.png?20|}}//<color #ed1c24>MORE INFORMATION</color>//

----    
    * [[editor:blocks:variables:increment|]]
    * [[editor:blocks:variables:set-array|]]
    * [[editor:blocks:variables:set-random|]]
    * [[editor:blocks:variables:set|]]
    * [[editor:blocks:variables:setup|]]
    * [[editor:blocks:variables:var|]]