Add a "generic" API for retrieving an ndarray data element via a linear index

Author: kgryte

lib/node_modules/@stdlib/ndarray/ctor/include/stdlib/ndarray/ctor.h

@@ -328,6 +328,11 @@ int8_t stdlib_ndarray_get_int8( const struct ndarray *arr, const int64_t *sub, i
 */
 uint8_t * stdlib_ndarray_iget_ptr( const struct ndarray *arr, const int64_t idx );
 
+/**
+* Returns an ndarray data element located at a specified linear index.
+*/
+int8_t stdlib_ndarray_iget( const struct ndarray *arr, const int64_t idx, void *out );
+
 /**
 * Returns a double-precision floating-point ndarray data element located at a specified linear index.
 */

lib/node_modules/@stdlib/ndarray/ctor/src/main.c

@@ -674,6 +674,27 @@ uint8_t * stdlib_ndarray_iget_ptr( const struct ndarray *arr, const int64_t idx
 	return ind;
 }
 
+/**
+* Returns an ndarray data element located at a specified linear index.
+*
+* ## Notes
+*
+* -   The function returns `-1` if unable to get an element and `0` otherwise.
+* -   The function requires a `void` pointer for the output address `out` in order to provide a generic API supporting ndarrays having different data types.
+*
+* @param arr  input ndarray
+* @param idx  linear view index
+* @param out  output address
+* @return     status code
+*/
+int8_t stdlib_ndarray_iget( const struct ndarray *arr, const int64_t idx, void *out ) {
+	uint8_t *ind = stdlib_ndarray_iget_ptr( arr, idx );
+	if ( ind == NULL ) {
+		return -1;
+	}
+	return stdlib_ndarray_get_ptr_value( arr, ind, out );
+}
+
 /**
 * Returns a double-precision floating-point ndarray data element located at a specified linear index.
 *