@stdlib/utils-map 0.0.1 → 0.2.0

package/docs/types/index.d.ts

@@ -16,19 +16,19 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /// <reference types="@stdlib/types"/>
 
-import { Collection } from '@stdlib/types/object';
-import { ndarray } from '@stdlib/types/ndarray';
+import { Collection } from '@stdlib/types/array';
+import { typedndarray } from '@stdlib/types/ndarray';
 
 /**
 * Callback invoked for each array element.
 *
 * @returns result
 */
-type Nullary = () => any;
+type Nullary<U, V> = ( this: V ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -36,7 +36,7 @@ type Nullary = () => any;
 * @param value - array element
 * @returns result
 */
-type Unary = ( value: any ) => any;
+type Unary<T, U, V> = ( this: V, value: T ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -45,7 +45,7 @@ type Unary = ( value: any ) => any;
 * @param index - element index
 * @returns result
 */
-type Binary = ( value: any, index: number ) => any;
+type Binary<T, U, V> = ( this: V, value: T, index: number ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -55,7 +55,7 @@ type Binary = ( value: any, index: number ) => any;
 * @param arr - array
 * @returns result
 */
-type Ternary = ( value: any, index: number, arr: ndarray ) => any;
+type Ternary<T, U, V> = ( this: V, value: T, index: number, arr: typedndarray<T> ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -65,7 +65,7 @@ type Ternary = ( value: any, index: number, arr: ndarray ) => any;
 * @param arr - array
 * @returns result
 */
-type ArrayTernary = ( value: any, index: number, arr: Collection ) => any;
+type ArrayTernary<T, U, V> = ( this: V, value: T, index: number, arr: Collection<T> ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -75,7 +75,7 @@ type ArrayTernary = ( value: any, index: number, arr: Collection ) => any;
 * @param arr - array
 * @returns result
 */
-type Callback = Nullary | Unary | Binary | Ternary;
+type Callback<T, U, V> = Nullary<U, V> | Unary<T, U, V> | Binary<T, U, V> | Ternary<T, U, V>;
 
 /**
 * Callback invoked for each array element.
@@ -85,7 +85,7 @@ type Callback = Nullary | Unary | Binary | Ternary;
 * @param arr - array
 * @returns result
 */
-type ArrayCallback = Nullary | Unary | Binary | ArrayTernary;
+type ArrayCallback<T, U, V> = Nullary<U, V> | Unary<T, U, V> | Binary<T, U, V> | ArrayTernary<T, U, V>;
 
 /**
 * Interface describing the main export.
@@ -110,9 +110,9 @@ interface Routine {
 	* @returns output array
 	*
 	* @example
-	* var naryFunction = require( `@stdlib/utils/nary-function` );
-	* var abs = require( `@stdlib/math/base/special/abs` );
-	* var array = require( `@stdlib/ndarray/array` );
+	* var naryFunction = require( '@stdlib/utils-nary-function' );
+	* var abs = require( '@stdlib/math-base-special-abs' );
+	* var array = require( '@stdlib/ndarray-array' );
 	*
 	* var opts = {
 	*     'dtype': 'generic'
@@ -125,7 +125,7 @@ interface Routine {
 	* var data = out.data;
 	* // returns [ 1, 2, 3, 4, 5, 6 ]
 	*/
-	( arr: ndarray, fcn: Callback, thisArg?: any ): ndarray;
+	<T = unknown, U = unknown, V = unknown>( arr: typedndarray<T>, fcn: Callback<T, U, V>, thisArg?: ThisParameterType<Callback<T, U, V>> ): typedndarray<U>;
 
 	/**
 	* Applies a function to each element in an array and assigns the result to an element in a new array.
@@ -144,15 +144,15 @@ interface Routine {
 	* @returns output array
 	*
 	* @example
-	* var naryFunction = require( `@stdlib/utils/nary-function` );
-	* var abs = require( `@stdlib/math/base/special/abs` );
+	* var naryFunction = require( '@stdlib/utils-nary-function' );
+	* var abs = require( '@stdlib/math-base-special-abs' );
 	*
 	* var arr = [ -1, -2, -3, -4, -5, -6 ];
 	*
 	* var out = map( arr, naryFunction( abs, 1 ) );
 	* // returns [ 1, 2, 3, 4, 5, 6 ]
 	*/
-	( arr: Collection, fcn: ArrayCallback, thisArg?: any ): Collection;
+	<T = unknown, U = unknown, V = unknown>( arr: Collection<T>, fcn: ArrayCallback<T, U, V>, thisArg?: ThisParameterType<ArrayCallback<T, U, V>> ): Array<U>;
 
 	/**
 	* Applies a function to each element in an array and assigns the result to an element in an output array.
@@ -172,9 +172,9 @@ interface Routine {
 	* @returns output array
 	*
 	* @example
-	* var naryFunction = require( `@stdlib/utils/nary-function` );
-	* var abs = require( `@stdlib/math/base/special/abs` );
-	* var array = require( `@stdlib/ndarray/array` );
+	* var naryFunction = require( '@stdlib/utils-nary-function' );
+	* var abs = require( '@stdlib/math-base-special-abs' );
+	* var array = require( '@stdlib/ndarray-array' );
 	*
 	* var opts = {
 	*     'dtype': 'generic',
@@ -188,7 +188,7 @@ interface Routine {
 	* var data = out.data;
 	* // returns [ 1, 2, 3, 4, 5, 6 ]
 	*/
-	assign( arr: ndarray, out: ndarray, fcn: Callback, thisArg?: any ): ndarray;
+	assign<T = unknown, U = unknown, V = unknown>( arr: typedndarray<T>, out: typedndarray<U>, fcn: Callback<T, U, V>, thisArg?: ThisParameterType<Callback<T, U, V>> ): typedndarray<U>;
 
 	/**
 	* Applies a function to each element in an array and assigns the result to an element in an output array.
@@ -208,8 +208,8 @@ interface Routine {
 	* @returns output array
 	*
 	* @example
-	* var naryFunction = require( `@stdlib/utils/nary-function` );
-	* var abs = require( `@stdlib/math/base/special/abs` );
+	* var naryFunction = require( '@stdlib/utils-nary-function' );
+	* var abs = require( '@stdlib/math-base-special-abs' );
 	*
 	* var arr = [ -1, -2, -3, -4, -5, -6 ];
 	* var out = [ 0, 0, 0, 0, 0, 0 ];
@@ -219,7 +219,7 @@ interface Routine {
 	* console.log( out );
 	* // => [ 1, 2, 3, 4, 5, 6 ]
 	*/
-	assign( arr: Collection, out: Collection, fcn: ArrayCallback, thisArg?: any ): Collection; // tslint:disable-line:max-line-length
+	assign<T = unknown, U = unknown, V = unknown>( arr: Collection<T>, out: Collection<U>, fcn: ArrayCallback<T, U, V>, thisArg?: ThisParameterType<Callback<T, U, V>> ): Collection<U>;
 }
 
 /**
@@ -239,8 +239,8 @@ interface Routine {
 * @returns output array
 *
 * @example
-* var naryFunction = require( `@stdlib/utils/nary-function` );
-* var abs = require( `@stdlib/math/base/special/abs` );
+* var naryFunction = require( '@stdlib/utils-nary-function' );
+* var abs = require( '@stdlib/math-base-special-abs' );
 *
 * var arr = [ -1, -2, -3, -4, -5, -6 ];
 *
@@ -248,9 +248,9 @@ interface Routine {
 * // returns [ 1, 2, 3, 4, 5, 6 ]
 *
 * @example
-* var naryFunction = require( `@stdlib/utils/nary-function` );
-* var abs = require( `@stdlib/math/base/special/abs` );
-* var array = require( `@stdlib/ndarray/array` );
+* var naryFunction = require( '@stdlib/utils-nary-function' );
+* var abs = require( '@stdlib/math-base-special-abs' );
+* var array = require( '@stdlib/ndarray-array' );
 *
 * var opts = {
 *     'dtype': 'generic'
@@ -264,8 +264,8 @@ interface Routine {
 * // returns [ 1, 2, 3, 4, 5, 6 ]
 *
 * @example
-* var naryFunction = require( `@stdlib/utils/nary-function` );
-* var abs = require( `@stdlib/math/base/special/abs` );
+* var naryFunction = require( '@stdlib/utils-nary-function' );
+* var abs = require( '@stdlib/math-base-special-abs' );
 *
 * var arr = [ -1, -2, -3, -4, -5, -6 ];
 * var out = [ 0, 0, 0, 0, 0, 0 ];
@@ -276,9 +276,9 @@ interface Routine {
 * // => [ 1, 2, 3, 4, 5, 6 ]
 *
 * @example
-* var naryFunction = require( `@stdlib/utils/nary-function` );
-* var abs = require( `@stdlib/math/base/special/abs` );
-* var array = require( `@stdlib/ndarray/array` );
+* var naryFunction = require( '@stdlib/utils-nary-function' );
+* var abs = require( '@stdlib/math-base-special-abs' );
+* var array = require( '@stdlib/ndarray-array' );
 *
 * var opts = {
 *     'dtype': 'generic',

package/lib/array.js

@@ -26,10 +26,10 @@
 * @private
 * @param {Object} x - object containing input array data
 * @param {ArrayLikeObject} x.data - input array data
-* @param {Function} x.getter - callback for accessing input array data elements
+* @param {Array<Function>} x.accessors - input array accessors
 * @param {Object} y - object containing output array data
 * @param {ArrayLikeObject} y.data - output array data
-* @param {Function} y.setter - callback for setting output array data elements
+* @param {Array<Function>} y.accessors - output array accessors
 * @param {Function} fcn - function to apply
 * @param {*} thisArg - function execution context
 * @returns {void}
@@ -50,11 +50,11 @@
 * // Create the input and output array objects:
 * var x = {
 *     'data': [ -1, -2, -3, -4, -5, -6 ],
-*     'getter': getter
+*     'accessors': [ getter, setter ]
 * };
 * var y = {
 *     'data': [ 0, 0, 0, 0, 0, 0 ],
-*     'setter': setter
+*     'accessors': [ getter, setter ]
 * };
 *
 * map( x, y, naryFunction( abs, 1 ) );
@@ -74,8 +74,8 @@ function map( x, y, fcn, thisArg ) {
 	ybuf = y.data;
 
 	// Cache accessors:
-	get = x.getter;
-	set = y.setter;
+	get = x.accessors[ 0 ];
+	set = y.accessors[ 1 ];
 
 	// Iterate over each element...
 	for ( i = 0; i < xbuf.length; i++ ) {

package/lib/assign.js

@@ -27,6 +27,7 @@ var ndarraylike2object = require( '@stdlib/ndarray-base-ndarraylike2object' );
 var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
 var broadcast = require( '@stdlib/ndarray-base-maybe-broadcast-array' );
 var isReadOnly = require( '@stdlib/ndarray-base-assert-is-read-only' );
+var format = require( '@stdlib/string-format' );
 var ndarrayFcn = require( './ndarray.js' );
 var arrayFcn = require( './array.js' );
 
@@ -90,11 +91,11 @@ function map( arr, out, fcn, thisArg ) {
 	var tmp;
 	var sh;
 	if ( !isFunction( fcn ) ) {
-		throw new TypeError( 'invalid argument. Third argument must be a function. Value: `' + fcn + '`.' );
+		throw new TypeError( format( 'invalid argument. Third argument must be a function. Value: `%s`.', fcn ) );
 	}
 	if ( isndarrayLike( arr ) ) { // note: assertion order matters here, as an ndarray-like object is also array-like
 		if ( !isndarrayLike( out ) ) {
-			throw new TypeError( 'invalid argument. If the input array is an ndarray, the output array must also be an ndarray. Value: `' + out + '`.' );
+			throw new TypeError( format( 'invalid argument. If the input array is an ndarray, the output array must also be an ndarray. Value: `%s`.', out ) );
 		}
 		if ( isReadOnly( out ) ) {
 			throw new Error( 'invalid argument. The output ndarray must be writable. Cannot write to a read-only ndarray.' );
@@ -111,7 +112,7 @@ function map( arr, out, fcn, thisArg ) {
 	}
 	if ( isArrayLikeObject( arr ) ) {
 		if ( !isArrayLikeObject( out ) || isndarrayLike( out ) ) {
-			throw new TypeError( 'invalid argument. If the input array is an array-like object, the output array must also be an array-like object. Value: `' + out + '`.' );
+			throw new TypeError( format( 'invalid argument. If the input array is an array-like object, the output array must also be an array-like object. Value: `%s`.', out ) );
 		}
 		if ( arr.length !== out.length ) {
 			throw new RangeError( 'invalid arguments. Input and output arrays must have the same length.' );
@@ -119,7 +120,7 @@ function map( arr, out, fcn, thisArg ) {
 		arrayFcn( arraylike2object( arr ), arraylike2object( out ), fcn, thisArg ); // eslint-disable-line max-len
 		return out;
 	}
-	throw new TypeError( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `' + arr + '`.' );
+	throw new TypeError( format( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `%s`.', arr ) );
 }
 
 

package/lib/main.js

@@ -27,6 +27,7 @@ var zeros = require( '@stdlib/array-base-zeros' );
 var ndarraylike2object = require( '@stdlib/ndarray-base-ndarraylike2object' );
 var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
 var ndzeros = require( '@stdlib/ndarray-zeros' );
+var format = require( '@stdlib/string-format' );
 var ndarrayFcn = require( './ndarray.js' );
 var arrayFcn = require( './array.js' );
 
@@ -79,7 +80,7 @@ var arrayFcn = require( './array.js' );
 function map( arr, fcn, thisArg ) {
 	var out;
 	if ( !isFunction( fcn ) ) {
-		throw new TypeError( 'invalid argument. Second argument must be a function. Value: `' + fcn + '`.' );
+		throw new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', fcn ) );
 	}
 	if ( isndarrayLike( arr ) ) { // note: assertion order matters here, as an ndarray-like object is also array-like
 		arr = ndarraylike2object( arr );
@@ -95,7 +96,7 @@ function map( arr, fcn, thisArg ) {
 		arrayFcn( arraylike2object( arr ), arraylike2object( out ), fcn, thisArg ); // eslint-disable-line max-len
 		return out;
 	}
-	throw new TypeError( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `' + arr + '`.' );
+	throw new TypeError( format( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `%s`.', arr ) );
 }
 
 

package/lib/ndarray.js

@@ -43,7 +43,7 @@ var MODE = 'throw';
 * @param {IntegerArray} x.strides - stride lengths
 * @param {NonNegativeInteger} x.offset - index offset
 * @param {string} x.order - specifies whether `x` is row-major (C-style) or column-major (Fortran-style)
-* @param {Function} x.getter - callback for accessing `x` data buffer elements
+* @param {Array<Function>} x.accessors - accessors for accessing data buffer elements
 * @param {Object} y - object containing output ndarray meta data
 * @param {string} y.dtype - data type
 * @param {Collection} y.data - data buffer
@@ -52,7 +52,7 @@ var MODE = 'throw';
 * @param {IntegerArray} y.strides - stride lengths
 * @param {NonNegativeInteger} y.offset - index offset
 * @param {string} y.order - specifies whether `y` is row-major (C-style) or column-major (Fortran-style)
-* @param {Function} y.setter - callback for setting `y` data buffer elements
+* @param {Array<Function>} y.accessors - accessors for accessing data buffer elements
 * @param {Function} fcn - function to apply
 * @param {*} thisArg - function execution context
 * @returns {void}
@@ -102,7 +102,7 @@ var MODE = 'throw';
 *     'strides': sx,
 *     'offset': ox,
 *     'order': 'row-major',
-*     'getter': getter
+*     'accessors': [ getter, setter ]
 * };
 * x.ref = x;
 *
@@ -115,7 +115,7 @@ var MODE = 'throw';
 *     'strides': sy,
 *     'offset': oy,
 *     'order': 'row-major',
-*     'setter': setter
+*     'accessors': [ getter, setter ]
 * };
 *
 * // Apply the unary function:
@@ -172,8 +172,8 @@ function map( x, y, fcn, thisArg ) {
 	ordy = y.order;
 
 	// Cache accessors:
-	get = x.getter;
-	set = y.setter;
+	get = x.accessors[ 0 ];
+	set = y.accessors[ 1 ];
 
 	// Cache the reference to the original input array:
 	ref = x.ref;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/utils-map",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Apply a function to each element in an array and assign the result to an element in an output array.",
   "license": "Apache-2.0",
   "author": {
@@ -37,39 +37,42 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/array-base-arraylike2object": "^0.0.x",
-    "@stdlib/array-base-zeros": "^0.0.x",
-    "@stdlib/assert-is-array-like-object": "^0.0.x",
-    "@stdlib/assert-is-function": "^0.0.x",
-    "@stdlib/assert-is-ndarray-like": "^0.0.x",
-    "@stdlib/ndarray-base-assert-is-read-only": "^0.0.x",
-    "@stdlib/ndarray-base-maybe-broadcast-array": "^0.0.x",
-    "@stdlib/ndarray-base-ndarraylike2object": "^0.0.x",
-    "@stdlib/ndarray-base-vind2bind": "^0.0.x",
-    "@stdlib/ndarray-zeros": "^0.0.x",
-    "@stdlib/types": "^0.0.x",
-    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.0.x"
+    "@stdlib/array-base-arraylike2object": "^0.2.0",
+    "@stdlib/array-base-zeros": "^0.2.0",
+    "@stdlib/assert-is-array-like-object": "^0.2.0",
+    "@stdlib/assert-is-function": "^0.2.0",
+    "@stdlib/assert-is-ndarray-like": "^0.2.0",
+    "@stdlib/ndarray-base-assert-is-read-only": "^0.2.0",
+    "@stdlib/ndarray-base-maybe-broadcast-array": "^0.2.0",
+    "@stdlib/ndarray-base-ndarraylike2object": "^0.2.0",
+    "@stdlib/ndarray-base-vind2bind": "^0.2.0",
+    "@stdlib/ndarray-zeros": "^0.2.0",
+    "@stdlib/string-format": "^0.2.0",
+    "@stdlib/types": "^0.3.1",
+    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.0",
+    "@stdlib/error-tools-fmtprodmsg": "^0.2.0"
   },
   "devDependencies": {
-    "@stdlib/array-base-filled": "^0.0.x",
-    "@stdlib/array-complex64": "^0.0.x",
-    "@stdlib/array-filled-by": "^0.0.x",
-    "@stdlib/array-float64": "^0.0.x",
-    "@stdlib/assert-is-array": "^0.0.x",
-    "@stdlib/bench": "^0.0.x",
-    "@stdlib/complex-float32": "^0.0.x",
-    "@stdlib/complex-imagf": "^0.0.x",
-    "@stdlib/complex-realf": "^0.0.x",
-    "@stdlib/math-base-special-abs": "^0.0.x",
-    "@stdlib/math-base-special-abs2": "^0.0.x",
-    "@stdlib/math-base-special-pow": "^0.0.x",
-    "@stdlib/ndarray-array": "^0.0.x",
-    "@stdlib/ndarray-ctor": "^0.0.x",
-    "@stdlib/random-base-discrete-uniform": "^0.0.x",
-    "@stdlib/utils-nary-function": "^0.0.x",
+    "@stdlib/array-base-filled": "^0.2.0",
+    "@stdlib/array-complex64": "^0.1.0",
+    "@stdlib/array-filled-by": "^0.1.0",
+    "@stdlib/array-float64": "^0.2.0",
+    "@stdlib/assert-is-array": "^0.2.0",
+    "@stdlib/complex-float32": "^0.2.0",
+    "@stdlib/complex-imagf": "^0.2.0",
+    "@stdlib/complex-realf": "^0.2.0",
+    "@stdlib/math-base-special-abs": "^0.2.0",
+    "@stdlib/math-base-special-abs2": "^0.2.0",
+    "@stdlib/math-base-special-pow": "^0.2.0",
+    "@stdlib/ndarray-array": "^0.1.0",
+    "@stdlib/ndarray-ctor": "^0.1.0",
+    "@stdlib/random-base-discrete-uniform": "^0.1.0",
+    "@stdlib/utils-nary-function": "^0.2.0",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
     "istanbul": "^0.4.1",
-    "tap-spec": "5.x.x"
+    "tap-min": "git+https://github.com/Planeshifter/tap-min.git",
+    "@stdlib/bench-harness": "^0.2.0",
+    "@stdlib/bench": "^0.3.1"
   },
   "engines": {
     "node": ">=0.10.0",
@@ -112,7 +115,7 @@
     "fcn"
   ],
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }

package/docs/repl.txt

@@ -1,106 +0,0 @@
-
-{{alias}}( arr, fcn[, thisArg] )
-    Applies a function to each element in an array and assigns the result to an
-    element in a new array.
-
-    The applied function is provided the following arguments:
-
-    - value: array element.
-    - index: element index.
-    - arr: input array.
-
-    The returned output array always has a "generic" data type. For example, if
-    provided an array-like object, the function returns a generic array. If
-    provided an ndarray, the function returns an ndarray having a "generic" data
-    type.
-
-    Parameters
-    ----------
-    arr: ArrayLikeObject|ndarray
-        Input array.
-
-    fcn: Function
-        Function to apply.
-
-    thisArg: any (optional)
-        Input function context.
-
-    Returns
-    -------
-    out: Array|ndarray
-        Output array.
-
-    Examples
-    --------
-    // array-like object:
-    > var f = {{alias:@stdlib/utils/nary-function}}( {{alias:@stdlib/math/base/special/abs}}, 1 );
-    > var arr = [ -1, -2, -3, -4, -5, -6 ];
-    > var out = {{alias}}( arr, f )
-    [ 1, 2, 3, 4, 5, 6 ]
-
-    // ndarray:
-    > arr = {{alias:@stdlib/ndarray/array}}( arr, { 'shape': [ 2, 3 ] } );
-    > out = {{alias}}( arr, f );
-    > var v = out.get( 1, 1 )
-    5
-
-
-{{alias}}.assign( arr, out, fcn[, thisArg] )
-    Applies a function to each element in an array and assigns the result to an
-    element in an output array.
-
-    The applied function is provided the following arguments:
-
-    - value: array element.
-    - index: element index.
-    - arr: input array.
-
-    Input and output arrays must be either both array-like objects or both
-    ndarray-like objects.
-
-    If input and output arrays are array-like objects, the arrays must have the
-    same number of elements.
-
-    If input and output arrays are both ndarray-like objects, the arrays *must*
-    be broadcast compatible.
-
-    Parameters
-    ----------
-    arr: ArrayLikeObject|ndarray
-        Input array.
-
-    out: ArrayLikeObject|ndarray
-        Output array.
-
-    fcn: Function
-        Function to apply.
-
-    thisArg: any (optional)
-        Input function context.
-
-    Returns
-    -------
-    out: Array|ndarray
-        Output array.
-
-    Examples
-    --------
-    // array-like object:
-    > var f = {{alias:@stdlib/utils/nary-function}}( {{alias:@stdlib/math/base/special/abs}}, 1 );
-    > var arr = [ -1, -2, -3, -4, -5, -6 ];
-    > var out = [ 0, 0, 0, 0, 0, 0 ];
-    > {{alias}}.assign( arr, out, f );
-    > out
-    [ 1, 2, 3, 4, 5, 6 ]
-
-    // ndarray:
-    > var opts = { 'shape': [ 2, 3 ] };
-    > arr = {{alias:@stdlib/ndarray/array}}( arr, opts );
-    > out = {{alias:@stdlib/ndarray/array}}( [ 0, 0, 0, 0, 0, 0 ], opts );
-    > {{alias}}.assign( arr, out, f );
-    > var v = out.get( 1, 1 )
-    5
-
-    See Also
-    --------
-