time-to-botec/js/node_modules/@stdlib/blas/gswap/README.md
NunoSempere b6addc7f05 feat: add the node modules
Necessary in order to clearly see the squiggle hotwiring.
2022-12-03 12:44:49 +00:00

2.6 KiB

gswap

Interchange two vectors.

Usage

var gswap = require( '@stdlib/blas/gswap' );

gswap( x, y )

Interchanges two vectors x and y.

var Float64Array = require( '@stdlib/array/float64' );
var array = require( '@stdlib/ndarray/array' );

var x = array( new Float64Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] ) );
var y = array( new Float64Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] ) );

gswap( x, y );

var xbuf = x.data;
// returns <Float64Array>[ 2.0, 6.0, -1.0, -4.0, 8.0 ]

var ybuf = y.data;
// returns <Float64Array>[ 4.0, 2.0, -3.0, 5.0, -1.0 ]

The function has the following parameters:

  • x: a 1-dimensional ndarray or an array-like object.
  • y: a 1-dimensional ndarray or an array-like object.

Notes

  • gswap() provides a higher-level interface to the BLAS level 1 function gswap.
  • In general, for best performance, especially for large vectors, provide 1-dimensional ndarrays whose underlying data type is either float64 or float32.

Examples

var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
var gswap = require( '@stdlib/blas/gswap' );

var rand1 = discreteUniform.factory( 0, 100 );
var rand2 = discreteUniform.factory( 0, 10 );

var x = [];
var y = [];
var i;
for ( i = 0; i < 10; i++ ) {
    x.push( rand1() );
    y.push( rand2() );
}
console.log( x );
console.log( y );

gswap( x, y );
console.log( x );
console.log( y );