Array Actions

Array Actions

appendArrayItem

Append an item to an array.

myArray = createArray()
appendArrayItem(myArray,"banana")
# Should return 1
log(myArray.length)

appendArrayItems

Append an array to an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
# Should return 3
log(myArray.length)

arrayContains

Check if an array contains a value.

myArray = createArray()
appendArrayItem(myArray,"banana")
# Should return true
hasBanana = arrayContains(myArray, "banana")
# Should return false
hasApple = arrayContains(myArray, "apple")

copyArray

Make a copy of an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
newArray = copyArray(myArray)
# Should return "banana"
log(newArray[1]) myArray = createArray(10)
# Should return 10
log(myArray.length)

createArray

Create an array.

myArray = createArray(10)
# Should return 10
log(myArray.length)

getArrayItem

Get an array item.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
myItem = getArrayItem(myArray,1)
# Should return "banana"
log(myItem)

getArraySize

Get the size of an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
numItems = getArraySize(myArray)
# Should return 3
log(numItems)

insertArrayItem

Insert an array item.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
insertArrayItem(myArray,2,"plum")
# Should return "apple,banana,plum,pear"
log(myArray)

insertArrayItems

Insert items from one array into another array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
insertArrayItems(myArray,1,["orange","grapes"])
# Should return "apple,orange,grapes,banana,pear"
log(myArray)

joinArray

Join the values of the items in an array into a string.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
myString = joinArray(myArray,"::")
# Should return "apple::banana::pear"
log(myString)

removeArrayItem

Remove and return an item from an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
removedItem = removeArrayItem(myArray,1)
# Should return "apple,pear"
log(myArray)
# Should return "banana"
log(removedItem)

removeArrayItems

Remove and return items from an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear","grapes","coconut"])
removedItems = removeArrayItems(myArray,1,2)
# Should return "apple,grapes,coconut"
log(myArray)
# Should return "banana,pear"
log(removedItems)

removeLastArrayItem

Remove and return the last item from an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear","grapes","coconut"])
removedItem = removeLastArrayItem(myArray)
# Should return "apple,banana,pear,grapes"
log(myArray)
# Should return "coconut"
log(removedItem)

reverseArray

Reverse the order of the items in an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear","grapes"])
reverseArray(myArray)
# Should return "grapes,pear,banana,apple"
log(myArray)

setArrayItem

Set array item.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
setArrayItem(myArray,2,"plum")
# Should return "apple,banana,plum"
log(myArray)

setArraySize

Set the size of an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear"])
setArraySize(myArray,1)
# Should return "apple"
log(myArray)

sliceArray

Create a new array from a subset of the items in an array.

myArray = createArray()
appendArrayItems(myArray,["apple","banana","pear","grapes"])
newArray = sliceArray(myArray,0,2)
# Should return "apple,banana,pear,grapes"
log(myArray)
# Should return "apple,banana"
log(newArray)

sortArray

Sort an array.

myArray = createArray()
appendArrayItems(myArray,["apple","pear","grapes","banana"])
sortArray(myArray)
# Should return "apple,banana,grapes,pear"
log(myArray)