feat: add function to return a dimension stride in units of elements

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: passed
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/ndarray/ctor/README.md

@@ -1592,6 +1592,49 @@ Notes:
 
 -   The function does perform bounds checking for the dimension index.
 
+#### stdlib_ndarray_stride_elements( \*arr, i )
+
+Returns an ndarray stride (in elements).
+
+```c
+#include "stdlib/ndarray/ctor.h"
+#include <stdint.h>
+#include <stdlib.h>
+#include <stdio.h>
+
+// ...
+
+// Create an ndarray:
+struct ndarray *x = stdlib_ndarray_allocate( ... );
+if ( x == NULL ) {
+    fprintf( stderr, "Error allocating memory.\n" );
+    exit( 1 );
+}
+
+// ...
+
+// Retrieve a stride:
+int64_t s = stdlib_ndarray_stride_elements( x, 0 );
+
+// ...
+
+// Free allocated memory:
+stdlib_ndarray_free( x );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **i**: `[in] int64_t` dimension index.
+
+```c
+int64_t stdlib_ndarray_stride_elements( const struct ndarray *arr, const int64_t i );
+```
+
+Notes:
+
+-   The function does perform bounds checking for the dimension index.
+
 #### stdlib_ndarray_strides( \*arr )
 
 Returns a pointer to an array containing ndarray strides (in bytes).

lib/node_modules/@stdlib/ndarray/ctor/benchmark/c/benchmark.c

@@ -3218,6 +3218,51 @@ static double benchmark65( void ) {
 	return elapsed;
 }
 
+/**
+* Runs a benchmark.
+*
+* @return elapsed time in seconds
+*/
+static double benchmark66( void ) {
+	double elapsed;
+	int64_t v;
+	int64_t j;
+	double t;
+	int i;
+
+	uint8_t buffer[] = { 0, 0, 0, 0, 0, 0 };
+	int64_t ndims = 2;
+	int64_t shape[] = { 3, 2 };
+	int64_t strides[] = { -2, -1 };
+	int64_t offset = 5;
+	int64_t nsubmodes = 1;
+	int8_t submodes[] = { STDLIB_NDARRAY_INDEX_ERROR };
+
+	struct ndarray *arr = stdlib_ndarray_allocate( STDLIB_NDARRAY_UINT8, buffer, ndims, shape, strides, offset, STDLIB_NDARRAY_ROW_MAJOR, STDLIB_NDARRAY_INDEX_ERROR, nsubmodes, submodes );
+	if ( arr == NULL ) {
+		printf( "unable to allocate memory\n" );
+		exit( 1 );
+	}
+
+	t = tic();
+	for ( i = 0; i < ITERATIONS; i++ ) {
+		j = (int64_t)( rand_double()*ndims );
+		v = stdlib_ndarray_stride_elements( arr, j );
+		if ( v != strides[ j ] ) {
+			printf( "unexpected result\n" );
+			break;
+		}
+	}
+	elapsed = tic() - t;
+
+	if ( v != strides[ j ] ) {
+		printf( "unexpected result\n" );
+	}
+	stdlib_ndarray_free( arr );
+
+	return elapsed;
+}
+
 /**
 * Main execution sequence.
 */
@@ -3687,5 +3732,12 @@ int main( void ) {
 		print_results( elapsed );
 		printf( "ok %d benchmark finished\n", count );
 	}
+	for ( i = 0; i < REPEATS; i++ ) {
+		count += 1;
+		printf( "# c::native::%s::get:stride_elements\n", NAME );
+		elapsed = benchmark66();
+		print_results( elapsed );
+		printf( "ok %d benchmark finished\n", count );
+	}
 	print_summary( count, count );
 }

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

@@ -133,6 +133,11 @@ int64_t * stdlib_ndarray_shape( const struct ndarray *arr );
 */
 int64_t stdlib_ndarray_stride( const struct ndarray *arr, const int64_t i );
 
+/**
+* Returns an ndarray stride (in elements).
+*/
+int64_t stdlib_ndarray_stride_elements( const struct ndarray *arr, const int64_t i );
+
 /**
 * Returns a pointer to an array containing ndarray strides (in bytes).
 */

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

@@ -413,6 +413,21 @@ int64_t stdlib_ndarray_stride( const struct ndarray *arr, const int64_t i ) {
 	return arr->strides[ i ];
 }
 
+/**
+* Returns an ndarray stride (in elements).
+*
+* ## Notes
+*
+* -   The function does not perform any sanity checks.
+*
+* @param arr  input ndarray
+* @param i    dimension index
+* @return     array stride
+*/
+int64_t stdlib_ndarray_stride_elements( const struct ndarray *arr, const int64_t i ) {
+	return arr->strides[ i ] / arr->BYTES_PER_ELEMENT;
+}
+
 /**
 * Returns a pointer to an array containing ndarray strides (in bytes).
 *