copy

Copy the elements of an array-like object to a new "generic" array.

Usage

var copy = require( '@stdlib/array/base/copy' );

copy( x )

Copies the elements of an array-like object to a new "generic" array.

var x = [ 1, 2, 3 ];

var out = copy( x );
// returns [ 1, 2, 3 ]

var bool = ( out === x );
// returns false

Examples

var Complex64Array = require( '@stdlib/array/complex64' );
var realf = require( '@stdlib/complex/float32/real' );
var imagf = require( '@stdlib/complex/float32/imag' );
var copy = require( '@stdlib/array/base/copy' );

// Create a complex number array:
var arr = new Complex64Array( 10 );

// Copy elements to a generic array:
var out = copy( arr );

// Retrieve the first element:
var z = out[ 0 ];
// returns <Complex64>

var re = realf( z );
// returns 0.0

var im = imagf( z );
// returns 0.0

console.log( '%d + %di', re, im );
// => '0 + 0i'