Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -10,6 +10,7 @@
 
 ### Features
 
+-   [`c38afb1`](https://github.com/stdlib-js/stdlib/commit/c38afb1481f0785a09095561486cb0e987609d37) - add float16 dtype support for `array/base/getter` [(#13223)](https://github.com/stdlib-js/stdlib/pull/13223)
 -   [`c81fa28`](https://github.com/stdlib-js/stdlib/commit/c81fa285dfb9908737f43e73032197a9c535e7a9) - add float16 dtype support to `array/filled` [(#13052)](https://github.com/stdlib-js/stdlib/pull/13052)
 -   [`0fbbe42`](https://github.com/stdlib-js/stdlib/commit/0fbbe42ac5285b2fc13893c2c62667a59aedf272) - add float16 dtype support to `array/zero-to` [(#13054)](https://github.com/stdlib-js/stdlib/pull/13054)
 -   [`b4e4ef2`](https://github.com/stdlib-js/stdlib/commit/b4e4ef2ab4b4818c248e41bedf68f2ff5c3dbcce) - add float16 datatype support in `array/dtypes` [(#9809)](https://github.com/stdlib-js/stdlib/pull/9809)
@@ -65,6 +66,7 @@ This release closes the following issue:
 
 <details>
 
+-   [`c38afb1`](https://github.com/stdlib-js/stdlib/commit/c38afb1481f0785a09095561486cb0e987609d37) - **feat:** add float16 dtype support for `array/base/getter` [(#13223)](https://github.com/stdlib-js/stdlib/pull/13223) _(by Gururaj Gurram, Athan Reines)_
 -   [`c81fa28`](https://github.com/stdlib-js/stdlib/commit/c81fa285dfb9908737f43e73032197a9c535e7a9) - **feat:** add float16 dtype support to `array/filled` [(#13052)](https://github.com/stdlib-js/stdlib/pull/13052) _(by Gururaj Gurram, Athan Reines)_
 -   [`1428ba4`](https://github.com/stdlib-js/stdlib/commit/1428ba4e084c92135e0fe4d2568e7180de91731e) - **docs:** update related packages sections [(#13158)](https://github.com/stdlib-js/stdlib/pull/13158) _(by stdlib-bot)_
 -   [`0fbbe42`](https://github.com/stdlib-js/stdlib/commit/0fbbe42ac5285b2fc13893c2c62667a59aedf272) - **feat:** add float16 dtype support to `array/zero-to` [(#13054)](https://github.com/stdlib-js/stdlib/pull/13054) _(by Gururaj Gurram, Athan Reines)_

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>

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;

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`.
 *