Function GetFirst

src/utils/array/GetFirst.js:34–76

(array, property, value, startIndex, endIndex)

 * @return {?object} The first matching element from the array, or `null` if no element could be found in the range given.
 */
var GetFirst = function (array, property, value, startIndex, endIndex)
{
    if (startIndex === undefined) { startIndex = 0; }
    if (endIndex === undefined) { endIndex = array.length; }

    var i;
    var child;

    if (startIndex !== -1)
    {
        if (SafeRange(array, startIndex, endIndex))
        {
            for (i = startIndex; i < endIndex; i++)
            {
                child = array[i];

                if (!property ||
                    (property && value === undefined && child.hasOwnProperty(property)) ||
                    (property && value !== undefined && child[property] === value))
                {
                    return child;
                }
            }
        }
    }
    else
        if (SafeRange(array, 0, endIndex))
        {
            for (i = endIndex; i >= 0; i--)
            {
                child = array[i];

                if (!property ||
                    (property && value === undefined && child.hasOwnProperty(property)) ||
                    (property && value !== undefined && child[property] === value))
                {
                    return child;
                }
            }
        }

    return null;
};

module.exports = GetFirst;