/* ** This file is part of JSDataChecker. ** ** JSDataChecker is free software: you can redistribute it and/or modify ** it under the terms of the GNU General Public License as published by ** the Free Software Foundation, either version 3 of the License, or ** (at your option) any later version. ** ** JSDataChecker is distributed in the hope that it will be useful, ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** GNU General Public License for more details. ** ** You should have received a copy of the GNU General Public License ** along with JSDataChecker. If not, see . ** ** Copyright (C) 2016 JSDataChecker - Donato Pirozzi (donatopirozzi@gmail.com) ** Distributed under the GNU GPL v3. For full terms see the file LICENSE. ** License: http://www.gnu.org/licenses/gpl.html GPL version 3 or higher **/ function ArrayUtils() {} /** * It tests if the array has an element with the specified key, * if does not have the key it initialises it with the object. * @param arr * @param key * @param object * @returns {*} * @constructor */ ArrayUtils.TestAndSet = function (arr, key, object) { if (typeof arr == 'undefined') return null; if (Array.isArray(arr) == false) return null; if (typeof arr[key] == 'undefined') arr[key] = object; return arr[key]; };//EndFunction. ArrayUtils.TestAndInitializeKey = function (obj, key, value) { if (typeof obj == 'undefined') return null; if (typeof obj[key] == 'undefined') obj[key] = value; return obj[key]; };//EndFunction. /*** * It tests whether the array has the key, if not it insert it; * then increases the value by one unit. * @param arr * @param key * @returns {The array} */ ArrayUtils.TestAndIncrement = function (arr, key) { var exists = arr[key]; if (typeof exists === 'undefined') arr[key] = 0; arr[key]++; return arr; };//EndFunction. /*** * It converts the object to an array. It loops through the object * keys/properties, retrieves the objects and pushes it in the array. * @param obj * @returns {Array} */ ArrayUtils.toFieldsArray = function (obj) { var fields = []; ArrayUtils.IteratorOverKeys(obj, function(field, key) { field.key = key; fields.push(field); }); return fields; };//EndFunction. /** * Iterate over the key within the array arr. For each array * value it calls the callback function. * @param arr * @param callback * @constructor */ ArrayUtils.IteratorOverKeys = function (arr, callback) { for (var property in arr) { if (arr.hasOwnProperty(property)) { var item = arr[property]; callback(item, property); } } };//EndFunction. /** * Find the item with the max value within the array. * @param arr * @returns {*} It is an object with index, key, value. */ ArrayUtils.FindMinMax = function (arr, fncompare) { var max1 = null; var max2 = null; for (var key in arr) { //if (max1 == null) //Only the first time. // max1 = {index: -1, key: key, value: arr[key]}; if (max1 == null || fncompare(arr[key], max1.value)) { max2 = max1; max1 = {index: -1, key: key, value: arr[key]}; } else if (max2 == null || fncompare(arr[key], max2.value)) max2 = {index: -1, key: key, value: arr[key]}; }//EndFor. return { first: max1, second: max2 }; }//EndFunction. ArrayUtils.isArray = function (arr) { if (Array.isArray(arr)) return (arr.length > 0); return false; }//EndFunction.