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'''
||<tablewidth="796px" tableheight="123px"#cccccc>'''Function ''' ||<#cccccc>'''Type''' ||<#cccccc>'''Description ''' ||||<style="text-align:center"> || ||
||[[#push|push]] ||array ||Adds one or more elements to the end of an array and returns the new length of the array. ||
||[[#pop|pop]] ||array ||Removes the last element from an array and returns the value of that element. ||
||[[#unshift|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|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. ||
||[[#concat|concat]] ||array ||Used to join two or more arrays together. ||
||[[#sort|sort]] ||array ||Used to sort the order of array elements. ||
||[[#join|join]] ||string ||Takes an array and joins the elements into one string. ||
||[[#IndexOf|IndexOf]] ||int ||Checks for the first instance of an element and returns its position. ||




= 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


= sort =
'''Usage:''' array.sort()

Used to sort the order of array elements.


'''Example:'''

 . array = ["b", "a", "d", "c"]
 . echo array.sort()

'''Result:'''

 . a,b,c,d


= join =
'''Usage:''' array.join()

Takes an array and joins the elements into one string.


'''Example:'''

 . array = ["a", "b", "c", "d"]
 . echo array.join()

'''Result:'''

 . "a,b,c,d"



= IndexOf =
'''Usage:''' array.indexOf()

Checks for the first instance of an element and returns its position. 

If the item is not found, it will return as "-1" 

If the item is present more than once, the indexOf method returns the position of the first occurrence. 

'''Example:'''

array = ["google", "yahoo", "DuckDuckGo", "Bing"]
echo array.indexOf("DuckDuckGo")


'''Result:'''

 . 2



----
CategoryFunctions