time-to-botec/js/node_modules/@stdlib/strided/base/ternary/docs/repl.txt
NunoSempere b6addc7f05 feat: add the node modules
Necessary in order to clearly see the squiggle hotwiring.
2022-12-03 12:44:49 +00:00

90 lines
3.1 KiB
Plaintext

{{alias}}( arrays, shape, strides, fcn )
Applies a ternary callback to strided input array elements and assigns
results to elements in a strided output array.
The `shape` and `strides` parameters determine which elements in the strided
input and output arrays are accessed at runtime.
Indexing is relative to the first index. To introduce an offset, use typed
array views.
Parameters
----------
arrays: ArrayLikeObject<ArrayLikeObject>
Array-like object containing three strided input arrays and one strided
output array.
shape: ArrayLikeObject<integer>
Array-like object containing a single element, the number of indexed
elements.
strides: ArrayLikeObject<integer>
Array-like object containing the stride lengths for the strided input
and output arrays.
fcn: Function
Ternary callback.
Examples
--------
> var x = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0 ] );
> var y = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0 ] );
> var z = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0 ] );
> var w = new {{alias:@stdlib/array/float64}}( [ 0.0, 0.0, 0.0, 0.0 ] );
> var shape = [ x.length ];
> var strides = [ 1, 1, 1, 1 ];
> function f( x, y, z ) { return x + y + z; };
> {{alias}}( [ x, y, z, w ], shape, strides, f );
> w
<Float64Array>[ 3.0, 6.0, 9.0, 12.0 ]
{{alias}}.ndarray( arrays, shape, strides, offsets, fcn )
Applies a ternary callback to strided input array elements and assigns
results to elements in a strided output array using alternative indexing
semantics.
While typed array views mandate a view offset based on the underlying
buffer, the `offsets` parameter supports indexing semantics based on
starting indices.
Parameters
----------
arrays: ArrayLikeObject<ArrayLikeObject>
Array-like object containing three strided input arrays and one strided
output array.
shape: ArrayLikeObject<integer>
Array-like object containing a single element, the number of indexed
elements.
strides: ArrayLikeObject<integer>
Array-like object containing the stride lengths for the strided input
and output arrays.
offsets: ArrayLikeObject<integer>
Array-like object containing the starting indices (i.e., index offsets)
for the strided input and output arrays.
fcn: Function
Ternary callback.
Examples
--------
> var x = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0 ] );
> var y = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0 ] );
> var z = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0 ] );
> var w = new {{alias:@stdlib/array/float64}}( [ 0.0, 0.0, 0.0, 0.0 ] );
> var shape = [ x.length ];
> var strides = [ 1, 1, 1, 1 ];
> var offsets = [ 0, 0, 0, 0 ];
> function f( x, y, z ) { return x + y + z; };
> {{alias}}.ndarray( [ x, y, z, w ], shape, strides, offsets, f );
> w
<Float64Array>[ 3.0, 6.0, 9.0, 12.0 ]
See Also
--------