copyIndexed
Copy the elements of an indexed array-like object to a new "generic" array.
Usage
var copyIndexed = require( '@stdlib/array/base/copy-indexed' );
copyIndexed( x )
Copies the elements of an indexed array-like object to a new "generic" array.
var x = [ 1, 2, 3 ];
var out = copyIndexed( x );
// returns [ 1, 2, 3 ]
var bool = ( out === x );
// returns false
Notes
- An indexed array-like object is a data structure in which one retrieves elements via integer indices using bracket
[]
notation (e.g.,Float64Array
,Int32Array
,Array
, etc). This is in contrast to an accessor array-like object in which one retrieves elements usingget
andset
methods (e.g.,Complex64Array
andComplex128Array
).
Examples
var filledBy = require( '@stdlib/array/filled-by' );
var randu = require( '@stdlib/random/base/randu' );
var copyIndexed = require( '@stdlib/array/base/copy-indexed' );
// Create a Float64Array:
var arr = filledBy( 10, 'float64', randu );
// Copy elements to a generic array:
var out = copyIndexed( arr );
// Retrieve the first element:
var x = out[ 0 ];
// returns <number>
console.log( '%d', x );