repl.txt (3504B)
1 2 {{alias}}( N, x, strideX, y, strideY ) 3 Interchanges two double-precision floating-point vectors. 4 5 The `N` and `stride` parameters determine how values from `x` are swapped 6 with values from `y`. 7 8 Indexing is relative to the first index. To introduce an offset, use typed 9 array views. 10 11 If `N` is less than or equal to `0`, the vectors are unchanged. 12 13 Parameters 14 ---------- 15 N: integer 16 Number of values to swap. 17 18 x: Float64Array 19 First input array. 20 21 strideX: integer 22 Index increment for `x`. 23 24 y: Float64Array 25 Second input array. 26 27 strideY: integer 28 Index increment for `y`. 29 30 Returns 31 ------- 32 y: Float64Array 33 Input array `y`. 34 35 Examples 36 -------- 37 // Standard usage: 38 > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] ); 39 > var y = new {{alias:@stdlib/array/float64}}( [ 6.0, 7.0, 8.0, 9.0, 10.0 ] ); 40 > {{alias}}( x.length, x, 1, y, 1 ) 41 <Float64Array>[ 1.0, 2.0, 3.0, 4.0, 5.0 ] 42 43 // Advanced indexing: 44 > x = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] ); 45 > y = new {{alias:@stdlib/array/float64}}( [ 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] ); 46 > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); 47 > {{alias}}( N, x, -2, y, 1 ) 48 <Float64Array>[ 5.0, 3.0, 1.0, 10.0, 11.0, 12.0 ] 49 50 // Using typed array views: 51 > var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] ); 52 > var y0 = new {{alias:@stdlib/array/float64}}( [ 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] ); 53 > var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); 54 > var y1 = new {{alias:@stdlib/array/float64}}( y0.buffer, y0.BYTES_PER_ELEMENT*3 ); 55 > N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 ); 56 > {{alias}}( N, x1, -2, y1, 1 ) 57 <Float64Array>[ 6.0, 4.0, 2.0 ] 58 > y0 59 <Float64Array>[ 7.0, 8.0, 9.0, 6.0, 4.0, 2.0 ] 60 61 62 {{alias}}.ndarray( N, x, strideX, offsetX, y, strideY, offsetY ) 63 Interchanges two double-precision floating-point vectors using alternative 64 indexing semantics. 65 66 While typed array views mandate a view offset based on the underlying 67 buffer, the `offset` parameters support indexing semantics based on starting 68 indices. 69 70 Parameters 71 ---------- 72 N: integer 73 Number of values to swap. 74 75 x: Float64Array 76 First input array. 77 78 strideX: integer 79 Index increment for `x`. 80 81 offsetX: integer 82 Starting index for `x`. 83 84 y: Float64Array 85 Second input array. 86 87 strideY: integer 88 Index increment for `y`. 89 90 offsetY: integer 91 Starting index for `y`. 92 93 Returns 94 ------- 95 y: Float64Array 96 Input array `y`. 97 98 Examples 99 -------- 100 // Standard usage: 101 > var x = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] ); 102 > var y = new {{alias:@stdlib/array/float64}}( [ 6.0, 7.0, 8.0, 9.0, 10.0 ] ); 103 > {{alias}}.ndarray( x.length, x, 1, 0, y, 1, 0 ) 104 <Float64Array>[ 1.0, 2.0, 3.0, 4.0, 5.0 ] 105 106 // Advanced indexing: 107 > x = new {{alias:@stdlib/array/float64}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] ); 108 > y = new {{alias:@stdlib/array/float64}}( [ 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] ); 109 > var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 ); 110 > {{alias}}.ndarray( N, x, 2, 1, y, -1, y.length-1 ) 111 <Float64Array>[ 7.0, 8.0, 9.0, 6.0, 4.0, 2.0 ] 112 113 See Also 114 -------- 115