1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
{{alias}}( N, x, sx, y, sy, clbk[, thisArg] )
Computes the inverse versed cosine of each element retrieved from an input
strided array `x` via a callback function and assigns each result to an
element in an output strided array `y`.
The `N` and stride parameters determine which elements in `x` and `y` are
accessed at runtime.
Indexing is relative to the first index. To introduce an offset, use typed
array views.
The callback function is provided six arguments:
- value: array element
- idx: iteration index
- xi: strided index (offsetX + idx*sx)
- yi: strided index (offsetY + idx*sy)
- x: the input array
- y: the destination array
If the callback function does not return any value (or equivalently,
explicitly returns `undefined`), the value is ignored.
Parameters
----------
N: integer
Number of indexed elements.
x: Array|TypedArray|Object
Input array/collection. If provided an object, the object must be array-
like (excluding strings and functions).
sx: integer
Index increment for `x`.
y: Array|TypedArray|Object
Destination array/collection. If provided an object, the object must be
array-like (excluding strings and functions).
sy: integer
Index increment for `y`.
clbk: Function
Callback function.
thisArg: any (optional)
Callback execution context.
Returns
-------
y: Array|TypedArray|Object
Destination array/collection.
Examples
--------
// Standard usage:
> var x = [ 0.0, -1.57, -0.5, -1.0 ];
> var y = [ 0.0, 0.0, 0.0, 0.0 ];
> function clbk( v ) { return v; };
> {{alias}}( x.length, x, 1, y, 1, clbk )
[ 0.0, ~2.177, ~1.047, ~1.571 ]
// Using `N` and stride parameters:
> y = [ 0.0, 0.0, 0.0, 0.0 ];
> {{alias}}( 2, x, 2, y, -1, clbk )
[ ~1.047, 0.0, 0.0, 0.0 ]
// Using view offsets:
> var x0 = new {{alias:@stdlib/array/float64}}( [ 0.0, -1.57, -0.5, -1.0 ] );
> var y0 = new {{alias:@stdlib/array/float64}}( [ 0.0, 0.0, 0.0, 0.0 ] );
> var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 );
> var y1 = new {{alias:@stdlib/array/float64}}( y0.buffer, y0.BYTES_PER_ELEMENT*2 );
> {{alias}}( 2, x1, -2, y1, 1, clbk )
<Float64Array>[ ~1.571, ~2.177 ]
> y0
<Float64Array>[ 0.0, 0.0, ~1.571, ~2.177 ]
{{alias}}.ndarray( N, x, sx, ox, y, sy, oy, clbk[, thisArg] )
Computes the inverse versed cosine of each element retrieved from an input
strided array `x` via a callback function and assigns each result to an
element in an output strided array `y` using alternative indexing
semantics.
While typed array views mandate a view offset based on the underlying
buffer, the offset parameters support indexing semantics based on starting
indices.
Parameters
----------
N: integer
Number of indexed elements.
x: Array|TypedArray|Object
Input array/collection. If provided an object, the object must be array-
like (excluding strings and functions).
sx: integer
Index increment for `x`.
ox: integer
Starting index for `x`.
y: Array|TypedArray|Object
Destination array/collection. If provided an object, the object must be
array-like (excluding strings and functions).
sy: integer
Index increment for `y`.
oy: integer
Starting index for `y`.
clbk: Function
Callback function.
thisArg: any (optional)
Callback execution context.
Returns
-------
y: Array|TypedArray|Object
Destination array/collection.
Examples
--------
// Standard usage:
> var x = [ 0.0, -1.57, -0.5, -1.0 ];
> var y = [ 0.0, 0.0, 0.0, 0.0 ];
> function clbk( v ) { return v; };
> {{alias}}.ndarray( x.length, x, 1, 0, y, 1, 0, clbk )
[ 0.0, ~2.177, ~1.047, ~1.571 ]
// Advanced indexing:
> x = [ 0.0, -1.57, -0.5, -1.0 ];
> y = [ 0.0, 0.0, 0.0, 0.0 ];
> {{alias}}.ndarray( 2, x, 2, 1, y, -1, y.length-1, clbk )
[ 0.0, 0.0, ~1.571, ~2.177 ]
See Also
--------
|
