Int8Array

Typed array constructor which returns a typed array representing an array of twos-complement 8-bit signed integers in the platform byte order.

Usage

var Int8Array = require( '@stdlib/array/int8' );

Int8Array()

A typed array constructor which returns a typed array representing an array of twos-complement 8-bit signed integers in the platform byte order.

var arr = new Int8Array();
// returns <Int8Array>

Int8Array( length )

Returns a typed array having a specified length.

var arr = new Int8Array( 5 );
// returns <Int8Array>[ 0, 0, 0, 0, 0 ]

Int8Array( typedarray )

Creates a typed array from another typed array.

var Float32Array = require( '@stdlib/array/float32' );

var arr1 = new Float32Array( [ 5.0, 5.0, 5.0 ] );
var arr2 = new Int8Array( arr1 );
// returns <Int8Array>[ 5, 5, 5 ]

Int8Array( obj )

Creates a typed array from an array-like object or iterable.

var arr = new Int8Array( [ 5.0, 5.0, 5.0 ] );
// returns <Int8Array>[ 5, 5, 5 ]

Int8Array( buffer[, byteOffset[, length]] )

Returns a typed array view of an ArrayBuffer.

var ArrayBuffer = require( '@stdlib/array/buffer' );

var buf = new ArrayBuffer( 4 );
var arr = new Int8Array( buf, 0, 4 );
// returns <Int8Array>[ 0, 0, 0, 0 ]

Properties

Int8Array.BYTES_PER_ELEMENT

Number of bytes per view element.

var nbytes = Int8Array.BYTES_PER_ELEMENT;
// returns 1

Int8Array.name

Typed array constructor name.

var str = Int8Array.name;
// returns 'Int8Array'

Int8Array.prototype.buffer

Read-only property which returns the ArrayBuffer referenced by the typed array.

var arr = new Int8Array( 5 );
var buf = arr.buffer;
// returns <ArrayBuffer>

Int8Array.prototype.byteLength

Read-only property which returns the length (in bytes) of the typed array.

var arr = new Int8Array( 5 );
var byteLength = arr.byteLength;
// returns 5

Int8Array.prototype.byteOffset

Read-only property which returns the offset (in bytes) of the typed array from the start of its ArrayBuffer.

var arr = new Int8Array( 5 );
var byteOffset = arr.byteOffset;
// returns 0

Int8Array.prototype.length

Read-only property which returns the number of view elements.

var arr = new Int8Array( 5 );
var len = arr.length;
// returns 5

Methods

TODO: add methods


Examples

var randu = require( '@stdlib/random/base/randu' );
var round = require( '@stdlib/math/base/special/round' );
var ctor = require( '@stdlib/array/int8' );

var arr;
var i;

arr = new ctor( 10 );
for ( i = 0; i < arr.length; i++ ) {
    arr[ i ] = round( randu()*100.0 );
}
console.log( arr );