# Uint8ClampedVector
> Create a clamped unsigned 8-bit integer vector (i.e., a one-dimensional [ndarray][@stdlib/ndarray/ctor]).
## Usage
```javascript
var Uint8ClampedVector = require( '@stdlib/ndarray/vector/uint8c' );
```
#### Uint8ClampedVector( \[options] )
Returns a one-dimensional clamped unsigned 8-bit integer [ndarray][@stdlib/ndarray/ctor].
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Uint8ClampedVector();
// 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`.
#### Uint8ClampedVector( length\[, options] )
Returns a one-dimensional clamped unsigned 8-bit integer [ndarray][@stdlib/ndarray/ctor] having a specified `length`.
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Uint8ClampedVector( 5 );
// returns
var len1 = numel( arr );
// returns 5
```
#### Uint8ClampedVector( obj\[, options] )
Creates a one-dimensional clamped unsigned 8-bit integer [ndarray][@stdlib/ndarray/ctor] from an array-like object or iterable.
```javascript
var numel = require( '@stdlib/ndarray/numel' );
var arr = new Uint8ClampedVector( [ 1, 2, 3 ] );
// returns
var len1 = numel( arr );
// returns 3
```
#### Uint8ClampedVector( buffer\[, byteOffset\[, length]]\[, options] )
Returns a one-dimensional clamped unsigned 8-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 Uint8ClampedVector( buf );
// returns
var len1 = numel( arr1 );
// returns 32
var arr2 = new Uint8ClampedVector( buf, 16 );
// returns
var len2 = numel( arr2 );
// returns 16
var arr3 = new Uint8ClampedVector( 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 Uint8ClampedVector = require( '@stdlib/ndarray/vector/uint8c' );
// Create a vector containing random values:
var x = new Uint8ClampedVector( 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