API: Array
arrShuffle
JavaScriptDart
Shuffle the order of the given array and return.
Parameters
array::any[]
Returns
any[]
Examples
_.arrShuffle([1, 2, 3, 4]); // Returns [4, 2, 3, 1]
arrWithDefault
JavaScriptDart
Initialize an array with a default value of a specific length.
Parameters
defaultValue::any
length::number || 0
Returns
any[]
Examples
_.arrWithDefault('abc', 4); // Returns ['abc', 'abc', 'abc', 'abc']
_.arrWithDefault(null, 3); // Returns [null, null, null]
arrWithNumber
JavaScriptDart
Creates and returns an Array in the order of start...end values.
Parameters
start::number
end::number
Returns
number[]
Examples
_.arrWithNumber(1, 3); // Returns [1, 2, 3]
_.arrWithNumber(0, 3); // Returns [0, 1, 2, 3]
arrUnique
JavaScriptDart
Remove duplicate values from array and two-dimensional array data. In the case of 2d arrays, json type data duplication is not removed.
Parameters
array::any[]
Returns
any[]
Examples
_.arrUnique([1, 2, 2, 3]); // Returns [1, 2, 3]
_.arrUnique([[1], [1], [2]]); // Returns [[1], [2]]
average
JavaScriptDart
Returns the average of all numeric values in an array.
Parameters
array::number[]
Returns
number
Examples
_.average([1, 5, 15, 50]); // Returns 17.75
arrMove
JavaScriptDart
Moves the position of a specific element in an array to the specified position. (Position starts from 0.)
Parameters
array::any[]
from::number
to::number
Returns
any[]
Examples
_.arrMove([1, 2, 3, 4], 1, 0); // Returns [2, 1, 3, 4]
arrTo1dArray
JavaScriptDart
Merges all elements of a multidimensional array into a one-dimensional array.
Parameters
array::any[]
Returns
any[]
Examples
_.arrTo1dArray([1, 2, [3, 4]], 5); // Returns [1, 2, 3, 4, 5]
arrRepeat
JavaScriptDart
Repeats the data of an Array
or Object
a specific number of times and returns it as a 1d array.
Parameters
array::any[]|object
count::number
Returns
any[]
Examples
_.arrRepeat([1, 2, 3, 4], 3); // Returns [1, 2, 3, 4, 1, 2, 3, 4, 1, 2, 3, 4]
_.arrRepeat({ a: 1, b: 2 }, 2); // Returns [{ a: 1, b: 2 }, { a: 1, b: 2 }]
arrCount
JavaScript
Returns the number of duplicates for each unique value in the given array. The array values can only be of type String
or Number
.
Parameters
array::string[]|number[]
count::number
Returns
object
Examples
_.arrCount(['a', 'a', 'a', 'b', 'c', 'b', 'a', 'd']); // Returns { a: 4, b: 2, c: 1, d: 1 }
sortByObjectKey
JavaScript
Sort array values by a specific key value in an array containing multiple objects. It does not affect the order or value of elements within an object.
If the numerically
option is true
, when sorting an array consisting of strings, it sorts first by the numbers contained in the strings, not by their names.
Parameters
array::any[]
key::string
descending::boolean
numerically::boolean
Returns
any[]
Examples
const obj = [
{
aa: 1,
bb: 'aaa',
cc: 'hi1'
},
{
aa: 4,
bb: 'ccc',
cc: 'hi10'
},
{
aa: 2,
bb: 'ddd',
cc: 'hi2'
},
{
aa: 3,
bb: 'bbb',
cc: 'hi11'
}
];
_.sortByObjectKey(obj, 'aa');
/*
[
{
aa: 1,
bb: 'aaa',
cc: 'hi1'
},
{
aa: 2,
bb: 'ddd',
cc: 'hi2'
},
{
aa: 3,
bb: 'bbb',
cc: 'hi11'
},
{
aa: 4,
bb: 'ccc',
cc: 'hi10'
}
]
*/
sortNumeric
JavaScript
When sorting an array consisting of strings, it sorts first by the numbers contained in the strings, not by their names. For example, given the array ['1-a', '100-a', '10-a', '2-a']
, it returns ['1-a', '2-a', '10-a', '100-a']
with the smaller numbers at the front.
Parameters
array::string[]
descending::boolean
Returns
string[]
Examples
_.sortNumeric(['a1a', 'b2a', 'aa1a', '1', 'a11a', 'a3a', 'a2a', '1a']);
// Returns ['1', '1a', 'a1a', 'a2a', 'a3a', 'a11a', 'aa1a', 'b2a']
arrGroupByMaxCount
JavaScript
Separates the data in the given array into a two-dimensional array containing only the maximum number of elements. For example, if you have an array of 6 data in 2 groups, this function will create a 2-dimensional array with 3 lengths.
Parameters
array::any[]
maxLengthPerGroup::number
Returns
any[]
Examples
_.arrGroupByMaxCount(['a', 'b', 'c', 'd', 'e'], 2);
// Returns [['a', 'b'], ['c', 'd'], ['e']]