time-to-botec/js/node_modules/@stdlib/strided/base/binary/docs/repl.txt

88 lines
2.9 KiB
Plaintext
Raw Normal View History

{{alias}}( arrays, shape, strides, fcn )
Applies a binary 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 two 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
Binary 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}}( [ 0.0, 0.0, 0.0, 0.0 ] );
> var shape = [ x.length ];
> var strides = [ 1, 1, 1 ];
> function f( x, y ) { return x + y; };
> {{alias}}( [ x, y, z ], shape, strides, f );
> z
<Float64Array>[ 2.0, 4.0, 6.0, 8.0 ]
{{alias}}.ndarray( arrays, shape, strides, offsets, fcn )
Applies a binary 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 two 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
Binary 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}}( [ 0.0, 0.0, 0.0, 0.0 ] );
> var shape = [ x.length ];
> var strides = [ 1, 1, 1 ];
> var offsets = [ 0, 0, 0 ];
> function f( x, y ) { return x + y; };
> {{alias}}.ndarray( [ x, y, z ], shape, strides, offsets, f );
> z
<Float64Array>[ 2.0, 4.0, 6.0, 8.0 ]
See Also
--------