oneTo
Generate a linearly spaced numeric array whose elements increment by
1starting from one.
Usage
var oneTo = require( '@stdlib/array/one-to' );
oneTo( n[, dtype] )
Generates a linearly spaced numeric array whose elements increment by 1 starting from one.
var arr = oneTo( 5 );
// returns <Float64Array>[ 1.0, 2.0, 3.0, 4.0, 5.0 ]
If n == 0, the function returns an empty array.
var arr = oneTo( 0 );
// returns <Float64Array>[]
The function recognizes the following data types:
float64: double-precision floating-point numbers (IEEE 754)float32: single-precision floating-point numbers (IEEE 754)complex128: double-precision complex floating-point numberscomplex64: single-precision complex floating-point numbersint32: 32-bit two's complement signed integersuint32: 32-bit unsigned integersint16: 16-bit two's complement signed integersuint16: 16-bit unsigned integersint8: 8-bit two's complement signed integersuint8: 8-bit unsigned integersuint8c: 8-bit unsigned integers clamped to0-255generic: generic JavaScript values
By default, the output array data type is float64 (i.e., a typed array). To specify an alternative data type, provide a dtype argument.
var arr = oneTo( 5, 'int32' );
// returns <Int32Array>[ 1, 2, 3, 4, 5 ]
Notes
- For complex number arrays, each element of the returned array has an imaginary component equal to
0.
Examples
var sort2hp = require( '@stdlib/blas/ext/base/gsort2hp' );
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var oneTo = require( '@stdlib/array/one-to' );
// Generate an array of random numbers:
var opts = {
'dtype': 'generic'
};
var x = discreteUniform( 10, 100, 200, opts );
// Generate a linearly-spaced array:
var y = oneTo( x.length, opts.dtype );
// Create a temporary array to avoid mutation:
var tmp = x.slice();
// Sort `y` according to the sort order of `x`:
sort2hp( x.length, 1, tmp, 1, y, 1 );
console.log( x );
console.log( y );