123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869 |
- import { maxArgumentCount } from '../../utils/function.js';
- import { forEach as forEachArray } from '../../utils/array.js';
- import { factory } from '../../utils/factory.js';
- var name = 'forEach';
- var dependencies = ['typed'];
- export var createForEach = /* #__PURE__ */factory(name, dependencies, _ref => {
- var {
- typed
- } = _ref;
- /**
- * Iterate over all elements of a matrix/array, and executes the given callback function.
- *
- * Syntax:
- *
- * math.forEach(x, callback)
- *
- * Examples:
- *
- * math.forEach([1, 2, 3], function(value) {
- * console.log(value)
- * })
- * // outputs 1, 2, 3
- *
- * See also:
- *
- * filter, map, sort
- *
- * @param {Matrix | Array} x The matrix to iterate on.
- * @param {Function} callback The callback function is invoked with three
- * parameters: the value of the element, the index
- * of the element, and the Matrix/array being traversed.
- */
- return typed(name, {
- 'Array, function': _forEach,
- 'Matrix, function': function MatrixFunction(x, callback) {
- x.forEach(callback);
- }
- });
- });
- /**
- * forEach for a multi dimensional array
- * @param {Array} array
- * @param {Function} callback
- * @private
- */
- function _forEach(array, callback) {
- // figure out what number of arguments the callback function expects
- var args = maxArgumentCount(callback);
- var recurse = function recurse(value, index) {
- if (Array.isArray(value)) {
- forEachArray(value, function (child, i) {
- // we create a copy of the index array and append the new index value
- recurse(child, index.concat(i));
- });
- } else {
- // invoke the callback function with the right number of arguments
- if (args === 1) {
- callback(value);
- } else if (args === 2) {
- callback(value, index);
- } else {
- // 3 or -1
- callback(value, index, array);
- }
- }
- };
- recurse(array, []);
- }
|