Diff for "Arrays"

Differences between revisions 2 and 3

The following functions can be used to manipulate an array.

Click each function name in the table below for more details of it, with examples.

Functions

Function	Type	Description
push	array	Adds one or more elements to the end of an array and returns the new length of the array.
pop	array	Removes the last element from an array and returns the value of that element.
unshift	array	Adds one or more elements to the beginning of an array and returns the new length of the array. The other elements in the array are moved from their original position, i, to i+1.
shift	array	Removes the first element from an array and returns that element. The remaining array elements are moved from their original position, i, to i-1.

push

Usage: array.push("x")

Adds one or more elements to the end of an array and returns the new length of the array.

Example:

myArray = ["a","b","c","d"]
echo "myArray = "+myArray
returnVal = myArray.push("e")
echo "myArray = "+myArray
echo "returnVal = "+returnVal

Result:

a,b,c,d
a,b,c,d,e
5

pop

Usage: array.pop()

Removes the last element from an array and returns the value of that element.

Example:

myArray = ["a","b","c","d"]
echo "myArray = "+myArray
returnVal = myArray.pop()
echo "myArray = "+myArray
echo "returnVal = "+returnVal

Result:

a,b,c,d
a,b,c
d

unshift

Usage: array.unshift("x")

Adds one or more elements to the beginning of an array and returns the new length of the array. The other elements in the array are moved from their original position, i, to i+1.

Example:

myArray = ["a","b","c","d"]
echo "myArray = "+myArray
returnVal = myArray.unshift("_")
echo "myArray = "+myArray
echo "returnVal = "+returnVal

Result:

a,b,c,d
_,a,b,c,d
5

shift

Usage: array.shift()

Removes the first element from an array and returns that element. The remaining array elements are moved from their original position, i, to i-1.

Example:

myArray = ["a","b","c","d"]
echo "myArray = "+myArray
returnVal = myArray.shift()
echo "myArray = "+myArray
echo "returnVal = "+returnVal

Result:

a,b,c,d
b,c,d
a

CategoryFunctions

Arrays (last edited 2015-04-17 00:19:57 by LKD70)

-  ⇤ ← Revision 2 as of 2014-01-27 11:41:06 → 
  Size: 2963
  Editor: Inanna
  Comment:
+   ← Revision 3 as of 2014-01-27 11:41:28 → ⇥
  Size: 2513
  Editor: Inanna
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 2:
-These should be written in the following formats: 
 .''variable.function(arguments)'', example - ''myVar.subStr(3,2)'' if your variable name was "myVar" and you wanted to use subStr() to find the 2 characters that begin 3 from the left.

 .''object.function(arguments)'', example - ''city.coords.split(",")'' if you wanted to split the coordinates of your city into an array to determine the seperate x and y values using the split() function.