Size: 2999
Comment:
|
Size: 2980
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
The following functions can be used to manipulate and array details from objects and variables. 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. |
The following functions can be used to manipulate an array. |
Line 11: | Line 6: |
||<tablewidth="796px" tableheight="123px"#cccccc>'''Function ''' ||<#cccccc>'''Type''' ||<#cccccc>'''Description '''||||<style="text-align:center"> || || | ||<tablewidth="796px" tableheight="123px"#cccccc>'''Function ''' ||<#cccccc>'''Type''' ||<#cccccc>'''Description ''' ||||<style="text-align:center"> || || |
Line 16: | Line 11: |
||[[#concat|concat]] ||array ||used to join two or more arrays together. || |
|
Line 24: | Line 22: |
.myArray = ["a","b","c","d"] .echo "myArray = "+myArray .returnVal = myArray.push("e") .echo "myArray = "+myArray .echo "returnVal = "+returnVal |
. myArray = ["a","b","c","d"] . echo "myArray = "+myArray . returnVal = myArray.push("e") . echo "myArray = "+myArray . echo "returnVal = "+returnVal |
Line 31: | Line 30: |
.a,b,c,d .a,b,c,d,e .5 |
. a,b,c,d . a,b,c,d,e . 5 |
Line 41: | Line 41: |
.myArray = ["a","b","c","d"] .echo "myArray = "+myArray .returnVal = myArray.pop() .echo "myArray = "+myArray .echo "returnVal = "+returnVal |
. myArray = ["a","b","c","d"] . echo "myArray = "+myArray . returnVal = myArray.pop() . echo "myArray = "+myArray . echo "returnVal = "+returnVal |
Line 48: | Line 49: |
.a,b,c,d .a,b,c .d |
|
Line 52: | Line 50: |
. a,b,c,d . a,b,c . d |
|
Line 59: | Line 60: |
.myArray = ["a","b","c","d"] .echo "myArray = "+myArray .returnVal = myArray.unshift("_") .echo "myArray = "+myArray .echo "returnVal = "+returnVal |
. myArray = ["a","b","c","d"] . echo "myArray = "+myArray . returnVal = myArray.unshift("_") . echo "myArray = "+myArray . echo "returnVal = "+returnVal |
Line 66: | Line 68: |
.a,b,c,d ._,a,b,c,d .5 |
. a,b,c,d . _,a,b,c,d . 5 |
Line 76: | Line 79: |
.myArray = ["a","b","c","d"] .echo "myArray = "+myArray .returnVal = myArray.shift() .echo "myArray = "+myArray .echo "returnVal = "+returnVal |
. myArray = ["a","b","c","d"] . echo "myArray = "+myArray . returnVal = myArray.shift() . echo "myArray = "+myArray . echo "returnVal = "+returnVal |
Line 83: | Line 87: |
.a,b,c,d .b,c,d .a |
. a,b,c,d . b,c,d . a = concat = '''Usage:''' array.concat() used to join two or more arrays together. ==== Example: ==== boy = ["Luke", "Bob","Jason"] girl = ["Emma", "Katie", "Chiara"] uni = ["Jordan","alex","Jessie"] names = uni.concat(girl,boy) echo names ==== Result: ==== Jordan,alex,Jessie,Emma,Katie,Chiara,Luke,Bob,Jason |
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 |
|
|
|
array |
Adds one or more elements to the end of an array and returns the new length of the array. |
||||
array |
Removes the last element from an array and returns the value of that element. |
||||
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. |
||||
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. |
||||
array |
used to join two or more arrays together. |
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
concat
Usage: array.concat()
used to join two or more arrays together.
Example:
boy = ["Luke", "Bob","Jason"]
girl = ["Emma", "Katie", "Chiara"]
uni = ["Jordan","alex","Jessie"]
names = uni.concat(girl,boy)
echo names
Result:
Jordan,alex,Jessie,Emma,Katie,Chiara,Luke,Bob,Jason