phaser/src/utils/array/CountAllMatching.js

37 lines
1,008 B
JavaScript
Raw Normal View History

/**
* @author Richard Davey <rich@photonstorm.com>
* @copyright 2018 Photon Storm Ltd.
* @license {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License}
*/
/**
* Returns the total number of elements in the array which have a property matching the given value.
*
* @function Phaser.Utils.Array.CountAllMatching
* @since 3.4.0
*
* @param {array} array - The array to search.
* @param {string} property - The property to test on each array element.
* @param {*} value - The value to test the property against. Must pass a strict (`===`) comparison check.
*
* @return {integer} The total number of elements with properties matching the given value.
*/
var CountAllMatching = function (array, property, value)
{
var total = 0;
for (var i = 0; i < array.length; i++)
{
var child = array[i];
if (child[property] === value)
{
total++;
}
}
return total;
};
module.exports = CountAllMatching;