import Check from "./Check.js";
|
import defaultValue from "./defaultValue.js";
|
import defined from "./defined.js";
|
|
/**
|
* Fill an array or a portion of an array with a given value.
|
*
|
* @param {Array} array The array to fill.
|
* @param {*} value The value to fill the array with.
|
* @param {Number} [start=0] The index to start filling at.
|
* @param {Number} [end=array.length] The index to end stop at.
|
*
|
* @returns {Array} The resulting array.
|
* @private
|
*/
|
function arrayFill(array, value, start, end) {
|
//>>includeStart('debug', pragmas.debug);
|
Check.defined("array", array);
|
Check.defined("value", value);
|
if (defined(start)) {
|
Check.typeOf.number("start", start);
|
}
|
if (defined(end)) {
|
Check.typeOf.number("end", end);
|
}
|
//>>includeEnd('debug');
|
|
if (typeof array.fill === "function") {
|
return array.fill(value, start, end);
|
}
|
|
var length = array.length >>> 0;
|
var relativeStart = defaultValue(start, 0);
|
// If negative, find wrap around position
|
var k =
|
relativeStart < 0
|
? Math.max(length + relativeStart, 0)
|
: Math.min(relativeStart, length);
|
var relativeEnd = defaultValue(end, length);
|
// If negative, find wrap around position
|
var last =
|
relativeEnd < 0
|
? Math.max(length + relativeEnd, 0)
|
: Math.min(relativeEnd, length);
|
|
// Fill array accordingly
|
while (k < last) {
|
array[k] = value;
|
k++;
|
}
|
return array;
|
}
|
export default arrayFill;
|
