Add function to retrieve an ndarray data element specified by a byte array ptr

Author: kgryte

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

@@ -263,6 +263,11 @@ int8_t stdlib_ndarray_disable_flags( struct ndarray *arr, const int64_t flags );
 */
 uint8_t * stdlib_ndarray_get_ptr( const struct ndarray *arr, const int64_t *sub );
 
+/**
+* Returns an ndarray data element specified by a byte array pointer.
+*/
+int8_t stdlib_ndarray_get_ptr_value( const struct ndarray *arr, const uint8_t *idx, void *out );
+
 /**
 * Returns an ndarray data element.
 */

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

@@ -330,23 +330,19 @@ uint8_t * stdlib_ndarray_get_ptr( const struct ndarray *arr, const int64_t *sub
 }
 
 /**
-* Returns an ndarray data element.
+* Returns an ndarray data element specified by a byte array pointer.
 *
 * ## 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 sub  ndarray subscripts
+* @param idx  byte array pointer to an ndarray data element
 * @param out  output address
 * @return     status code
 */
-int8_t stdlib_ndarray_get( const struct ndarray *arr, const int64_t *sub, void *out ) {
-	uint8_t *idx = stdlib_ndarray_get_ptr( arr, sub );
-	if ( idx == NULL ) {
-		return -1;
-	}
+int8_t stdlib_ndarray_get_ptr_value( const struct ndarray *arr, const uint8_t *idx, void *out ) {
 	switch ( arr->dtype ) {
 	case STDLIB_NDARRAY_FLOAT64:
 		*(double *)out = *(double *)idx;
@@ -382,6 +378,27 @@ int8_t stdlib_ndarray_get( const struct ndarray *arr, const int64_t *sub, void *
 	return -1;
 }
 
+/**
+* Returns an ndarray data element.
+*
+* ## 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 sub  ndarray subscripts
+* @param out  output address
+* @return     status code
+*/
+int8_t stdlib_ndarray_get( const struct ndarray *arr, const int64_t *sub, void *out ) {
+	uint8_t *idx = stdlib_ndarray_get_ptr( arr, sub );
+	if ( idx == NULL ) {
+		return -1;
+	}
+	return stdlib_ndarray_get_ptr_value( arr, idx, out );
+}
+
 /**
 * Returns a double-precision floating-point ndarray data element.
 *