# Complex64Vector
> Create a single-precision complex floating-point vector (i.e., a one-dimensional [ndarray][@stdlib/ndarray/ctor]).
## Usage
```javascript
var Complex64Vector = require( '@stdlib/ndarray/vector/complex64' );
```
#### Complex64Vector( \[options] )
Returns a one-dimensional single-precision complex floating-point [ndarray][@stdlib/ndarray/ctor].
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Complex64Vector();
// returns
var len = numel( arr );
// returns 0
```
The function accepts the following options:
- **order**: specifies whether an [ndarray][@stdlib/ndarray/ctor] is `'row-major'` (C-style) or `'column-major'` (Fortran-style). Default: `'row-major'`.
- **mode**: specifies how to handle indices which exceed array dimensions (see [`ndarray`][@stdlib/ndarray/ctor]). Default: `'throw'`.
- **readonly**: boolean indicating whether an array should be **read-only**. Default: `false`.
#### Complex64Vector( length\[, options] )
Returns a one-dimensional single-precision complex floating-point [ndarray][@stdlib/ndarray/ctor] having a specified `length`.
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Complex64Vector( 5 );
// returns
var len1 = numel( arr );
// returns 5
```
#### Complex64Vector( obj\[, options] )
Creates a one-dimensional single-precision complex floating-point [ndarray][@stdlib/ndarray/ctor] from an array-like object or iterable.
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Complex64Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
// returns
var len1 = numel( arr );
// returns 3
```
#### Complex64Vector( buffer\[, byteOffset\[, length]]\[, options] )
Returns a one-dimensional single-precision complex floating-point [ndarray][@stdlib/ndarray/ctor] view of an [`ArrayBuffer`][@stdlib/array/buffer].
```javascript
var ArrayBuffer = require( '@stdlib/array/buffer' );
var numel = require( '@stdlib/ndarray/numel' );
var buf = new ArrayBuffer( 64 );
var arr1 = new Complex64Vector( buf );
// returns
var len1 = numel( arr1 );
// returns 8
var arr2 = new Complex64Vector( buf, 16 );
// returns
var len2 = numel( arr2 );
// returns 6
var arr3 = new Complex64Vector( buf, 16, 1 );
// returns
var len3 = numel( arr3 );
// returns 1
```
## Examples
```javascript
var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var sum = require( '@stdlib/blas/ext/sum' );
var map = require( '@stdlib/ndarray/map' );
var realf = require( '@stdlib/complex/float32/real' );
var imagf = require( '@stdlib/complex/float32/imag' );
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var Complex64Vector = require( '@stdlib/ndarray/vector/complex64' );
// Create a vector containing random values:
var x = new Complex64Vector( discreteUniform( 20, 0, 100 ) );
// Compute the sum:
var v = sum( x );
console.log( v.get() );
// Define a function which applies a threshold to real and imaginary components:
function threshold( v ) {
if ( realf( v ) > 10 && imagf( v ) > 10 ) {
return v;
}
return new Complex64( 0.0, 0.0 );
}
// Apply threshold:
var y = map( x, threshold );
// Recompute the sum:
v = sum( y );
console.log( v.get() );
```
[@stdlib/array/buffer]: https://www.npmjs.com/package/@stdlib/array-buffer
[@stdlib/ndarray/ctor]: https://github.com/stdlib-js/ndarray/tree/main/ctor