cswap.native.js (1994B)
1 /** 2 * @license Apache-2.0 3 * 4 * Copyright (c) 2020 The Stdlib Authors. 5 * 6 * Licensed under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 19 'use strict'; 20 21 // MODULES // 22 23 var Float32Array = require( '@stdlib/array/float32' ); 24 var addon = require( './../src/addon.node' ); 25 26 27 // MAIN // 28 29 /** 30 * Interchanges two complex single-precision floating-point vectors. 31 * 32 * @param {PositiveInteger} N - number of values to swap 33 * @param {Complex64Array} x - first input array 34 * @param {integer} strideX - `x` stride length 35 * @param {Complex64Array} y - second input array 36 * @param {integer} strideY - `y` stride length 37 * @returns {Complex64Array} `y` 38 * 39 * @example 40 * var Complex64Array = require( '@stdlib/array/complex64' ); 41 * var real = require( '@stdlib/complex/real' ); 42 * var imag = require( '@stdlib/complex/imag' ); 43 * 44 * var x = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] ); 45 * var y = new Complex64Array( [ 7.0, 8.0, 9.0, 10.0, 11.0, 12.0 ] ); 46 * 47 * cswap( x.length, x, 1, y, 1 ); 48 * 49 * var z = y.get( 0 ); 50 * // returns <Complex64> 51 * 52 * var re = real( z ); 53 * // returns 1.0 54 * 55 * var im = imag( z ); 56 * // returns 2.0 57 * 58 * z = x.get( 0 ); 59 * // returns <Complex64> 60 * 61 * re = real( z ); 62 * // returns 7.0 63 * 64 * im = imag( z ); 65 * // returns 8.0 66 */ 67 function cswap( N, x, strideX, y, strideY ) { 68 var viewX = new Float32Array( x.buffer, x.byteOffset, x.length*2 ); 69 var viewY = new Float32Array( y.buffer, y.byteOffset, y.length*2 ); 70 addon( N, viewX, strideX, viewY, strideY ); 71 return y; 72 } 73 74 75 // EXPORTS // 76 77 module.exports = cswap;