Module Array

Removes all items of the specified array, making it empty.

example

const myNumbers = [3, 5, 6, 7]
// remove all items
JMap.Util.Array.clear(myNumbers)
console.log(`Count=${myNumbers.length}`)
// display message "Count=0"

Search for first element in the given object array, for a given attribute name and value.

example

const myObjects = [{
 id: 1,
 name: "Green"
}, {
 id: 2,
 name: "Red"
}, {
 id: 3,
 name: "Blue"
}]
// search for an object in the given array, having attribute "name" equals to "red", and returns found object or undefined
const foundObject = JMap.Util.Array.findByProperty(myObjects, "name", "Red")
console.log(`Found object: "${JSON.parse(foundObject)}"`)
// display message 'Found object: "{ \"id\": 2, \"name\": \"Red\" }"'

Search for first element index in the given object array, for a given attribute name and value.

example

const myObjects = [{
 id: 1,
 name: "Green"
}, {
 id: 2,
 name: "Red"
}, {
 id: 3,
 name: "Blue"
}]
// search for an object in the array that have attribute "name" equals to "red", and return its index position in the array
const objectIndex = JMap.Util.Array.findIndexByProperty(myObjects, "name", "Red")
console.log(`Object index: ${objectIndex}`)
// display message 'Object index: 1'

Remove given element in given array.

example

const myNumbers = [3, 5, 6, 7]
// remove element 6 in array
JMap.Util.Array.remove(myNumbers, 6)
console.log(`Now my numbers are [${myNumbers.join(", ")}]`)
// display message "Now my numbers are [3, 5, 7]"

Remove the first occurence.

example

const myObjects = [{
 id: 1,
 name: "Green"
}, {
 id: 2,
 name: "Red"
}, {
 id: 3,
 name: "Blue"
}]
// remove in the array the object that have a property "name" equals to "Red"
JMap.Util.Array.removeByProperty(myObjects, "name", "Red")
console.log(`myObjects: [${myObjects.join(", "")}]`)
// display message 'myObjects: [{ \"id\": 1, \"name\": \"Green\" }, { \"id\": 3, \"name\": \"Blue\" }]'