feat: add float16 dtype support for array/base/getter

lib/node_modules/@stdlib/array/base/getter/README.md

@@ -97,33 +97,37 @@ arr = filled( 2.0, 10, 'float32' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 2.0
 
-arr = filled( 3, 10, 'int32' );
+arr = filled( 3.0, 10, 'float16' );
 v = getter( dtype( arr ) )( arr, 2 );
-// returns 3
+// returns 3.0
 
-arr = filled( 4, 10, 'int16' );
+arr = filled( 4, 10, 'int32' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 4
 
-arr = filled( 5, 10, 'int8' );
+arr = filled( 5, 10, 'int16' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 5
 
-arr = filled( 6, 10, 'uint32' );
+arr = filled( 6, 10, 'int8' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 6
 
-arr = filled( 7, 10, 'uint16' );
+arr = filled( 7, 10, 'uint32' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 7
 
-arr = filled( 8, 10, 'uint8' );
+arr = filled( 8, 10, 'uint16' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 8
 
-arr = filled( 9, 10, 'uint8c' );
+arr = filled( 9, 10, 'uint8' );
 v = getter( dtype( arr ) )( arr, 2 );
 // returns 9
+
+arr = filled( 10, 10, 'uint8c' );
+v = getter( dtype( arr ) )( arr, 2 );
+// returns 10
 ```
 
 </section>

lib/node_modules/@stdlib/array/base/getter/benchmark/benchmark.js

@@ -133,6 +133,30 @@ bench( format( '%s:dtype=float32', pkg ), function benchmark( b ) {
 	b.end();
 });
 
+bench( format( '%s:dtype=float16', pkg ), function benchmark( b ) {
+	var arr;
+	var get;
+	var i;
+	var v;
+
+	arr = filledBy( 100, 'float16', rand );
+	get = getter( dtype( arr ) );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		v = get( arr, i%arr.length );
+		if ( v !== v ) {
+			b.fail( 'should not return NaN' );
+		}
+	}
+	b.toc();
+	if ( isnan( v ) ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
 bench( format( '%s:dtype=int32', pkg ), function benchmark( b ) {
 	var arr;
 	var get;

lib/node_modules/@stdlib/array/base/getter/docs/types/index.d.ts

@@ -20,7 +20,7 @@
 
 /// <reference types="@stdlib/types"/>
 
-import { Collection } from '@stdlib/types/array';
+import { Collection, Float16Array } from '@stdlib/types/array';
 
 /**
 * Returns an element from a `Float64Array`.
@@ -40,6 +40,15 @@ type GetFloat64 = ( arr: Float64Array, idx: number ) => number | void;
 */
 type GetFloat32 = ( arr: Float32Array, idx: number ) => number | void;
 
+/**
+* Returns an element from a `Float16Array`.
+*
+* @param arr - input array
+* @param idx - element index
+* @returns element value
+*/
+type GetFloat16 = ( arr: Float16Array, idx: number ) => number | void;
+
 /**
 * Returns an element from an `Int32Array`.
 *
@@ -155,6 +164,23 @@ declare function getter( dtype: 'float64' ): GetFloat64;
 */
 declare function getter( dtype: 'float32' ): GetFloat32;
 
+/**
+* Returns an accessor function for retrieving an element from a `Float16Array`.
+*
+* @param dtype - data type
+* @returns accessor function
+*
+* @example
+* var Float16Array = require( '@stdlib/array/float16' );
+*
+* var arr = new Float16Array( [ 1, 2, 3, 4 ] );
+*
+* var get = getter( 'float16' );
+* var v = get( arr, 2 );
+* // returns 3.0
+*/
+declare function getter( dtype: 'float16' ): GetFloat16;
+
 /**
 * Returns an accessor function for retrieving an element from an `Int32Array`.
 *