# Uint32Vector
> Create an unsigned 32-bit integer vector (i.e., a one-dimensional [ndarray][@stdlib/ndarray/ctor]).
## Usage
```javascript
var Uint32Vector = require( '@stdlib/ndarray/vector/uint32' );
```
#### Uint32Vector( \[options] )
Returns a one-dimensional unsigned 32-bit integer [ndarray][@stdlib/ndarray/ctor].
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Uint32Vector();
// 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`.
#### Uint32Vector( length\[, options] )
Returns a one-dimensional unsigned 32-bit integer [ndarray][@stdlib/ndarray/ctor] having a specified `length`.
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Uint32Vector( 5 );
// returns
var len1 = numel( arr );
// returns 5
```
#### Uint32Vector( obj\[, options] )
Creates a one-dimensional unsigned 32-bit integer [ndarray][@stdlib/ndarray/ctor] from an array-like object or iterable.
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Uint32Vector( [ 1, 2, 3 ] );
// returns
var len1 = numel( arr );
// returns 3
```
#### Uint32Vector( buffer\[, byteOffset\[, length]]\[, options] )
Returns a one-dimensional unsigned 32-bit integer [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( 32 );
var arr1 = new Uint32Vector( buf );
// returns
var len1 = numel( arr1 );
// returns 8
var arr2 = new Uint32Vector( buf, 16 );
// returns
var len2 = numel( arr2 );
// returns 4
var arr3 = new Uint32Vector( 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 Uint32Vector = require( '@stdlib/ndarray/vector/uint32' );
// Create a vector containing random values:
var x = new Uint32Vector( discreteUniform( 10, 0, 100 ) );
// Compute the sum:
var v = sum( x );
console.log( v.get() );
// Define a function which applies a threshold to individual values:
function threshold( v ) {
return ( v > 10 ) ? v : 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
[@stdlib/ndarray/vector/float64]: https://github.com/stdlib-js/ndarray/tree/main/vector/float64
[@stdlib/ndarray/vector/float32]: https://github.com/stdlib-js/ndarray/tree/main/vector/float32
[@stdlib/ndarray/vector/int16]: https://github.com/stdlib-js/ndarray/tree/main/vector/int16
[@stdlib/ndarray/vector/int32]: https://github.com/stdlib-js/ndarray/tree/main/vector/int32
[@stdlib/ndarray/vector/int8]: https://github.com/stdlib-js/ndarray/tree/main/vector/int8
[@stdlib/ndarray/vector/uint16]: https://github.com/stdlib-js/ndarray/tree/main/vector/uint16
[@stdlib/ndarray/vector/uint8]: https://github.com/stdlib-js/ndarray/tree/main/vector/uint8
[@stdlib/ndarray/vector/uint8c]: https://github.com/stdlib-js/ndarray/tree/main/vector/uint8c
[@stdlib/ndarray/vector/complex128]: https://github.com/stdlib-js/ndarray/tree/main/vector/complex128
[@stdlib/ndarray/vector/complex64]: https://github.com/stdlib-js/ndarray/tree/main/vector/complex64
[@stdlib/ndarray/vector/bool]: https://github.com/stdlib-js/ndarray/tree/main/vector/bool
[@stdlib/ndarray/vector/ctor]: https://github.com/stdlib-js/ndarray/tree/main/vector/ctor