Document _toArray, add test

Author: twisterghost

README.md

@@ -40,6 +40,7 @@ gdash is a functional utility library for GML, inspired by [lodash](https://loda
   * [`_split(string, splitter)`](#_splitstring-splitter)
   * [`_spread(script, argArray)`](#_spreadscript-argarray)
   * [`_times(script)`](#_timesscript)
+  * [`_toArray(list)`](#_toarraylist)
   * [`_typeOf(value)`](#_typeofvalue)
   * [`_uniq(array)`](#_uniqarray)
 
@@ -542,6 +543,16 @@ _times(3, returnTheValue5);
 // => [5, 5, 5];
 ```
 
+### `_toArray(list)`
+
+Returns the given ds_list as an array
+
+```
+@param {DS_List} the list to convert
+@returns {Array} An array representation of the given list
+Note: If the given list is of size 0, this will return undefined
+```
+
 ### `_typeOf(value)`
 
 Returns the variable type of the given argument

src/gdash/objects/obj_gdash_test_2/Other_23.gml

@@ -1 +1,13 @@
-test_suite_pass();
+/// _toArray
+test_start("_toArray", "Converts a list to an array");
+
+var list = ds_list_create();
+ds_list_add(1, 2, 3, 4, 5);
+
+var arr = _toArray(list);
+
+for (var i = 0; i < _length(arr); i++) {
+    assert_equal(list[| i], arr[i]);
+}
+
+test_end();

src/gdash/objects/obj_gdash_test_2/Other_24.gml

@@ -0,0 +1 @@
+test_suite_pass();

src/gdash/objects/obj_gdash_test_2/obj_gdash_test_2.yy

@@ -1,12 +1,18 @@
 /// @desc Converts the given ds_list to an array
 /// @param list
+/// Note: If the given list is of size 0, this will return undefined.
 
 var list = argument0;
 var listSize = ds_list_size(list);
 var array;
+array[0] = undefined;
 
 for (var i = listSize - 1; i >= 0; i--) {
     array[i] = list[| i];
 }
 
+if (is_undefined(array[0])) {
+    return undefined;
+}
+
 return array;