feat: add function for returning the number of bytes per ndarray element

---
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

@@ -920,6 +920,44 @@ The function accepts the following arguments:
 int64_t stdlib_ndarray_byte_length( const struct ndarray *arr );
 ```
 
+#### stdlib_ndarray_byte_length_per_element( \*arr )
+
+Returns the number of bytes per ndarray element.
+
+```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 the number of bytes per element:
+int64_t nb = stdlib_ndarray_byte_length_per_element( x );
+
+// ...
+
+// Free allocated memory:
+stdlib_ndarray_free( x );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+
+```c
+int64_t stdlib_ndarray_byte_length_per_element( const struct ndarray *arr );
+```
+
 #### stdlib_ndarray_data( \*arr )
 
 Returns a pointer to an ndarray's underlying byte array.

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

@@ -3174,6 +3174,50 @@ static double benchmark64( void ) {
 	return elapsed;
 }
 
+/**
+* Runs a benchmark.
+*
+* @return elapsed time in seconds
+*/
+static double benchmark65( void ) {
+	double elapsed;
+	int64_t v;
+	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 = 0;
+	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++ ) {
+		// NOTE: this is likely to be optimized away by a modern compiler, making this benchmark meaningless.
+		v = stdlib_ndarray_byte_length_per_element( arr );
+		if ( v != 1 ) {
+			printf( "unexpected result\n" );
+			break;
+		}
+	}
+	elapsed = tic() - t;
+
+	if ( v != 1 ) {
+		printf( "unexpected result\n" );
+	}
+	stdlib_ndarray_free( arr );
+
+	return elapsed;
+}
+
 /**
 * Main execution sequence.
 */
@@ -3636,5 +3680,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:byte_length_per_element\n", NAME );
+		elapsed = benchmark65();
+		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

@@ -48,6 +48,11 @@ struct ndarray * stdlib_ndarray_allocate( int16_t dtype, uint8_t *data, int64_t
 */
 int64_t stdlib_ndarray_byte_length( const struct ndarray *arr );
 
+/**
+* Returns the number of bytes per ndarray element.
+*/
+int64_t stdlib_ndarray_byte_length_per_element( const struct ndarray *arr );
+
 /**
 * Returns a pointer to an ndarray's underlying byte array.
 */

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

@@ -162,6 +162,16 @@ int64_t stdlib_ndarray_byte_length( const struct ndarray *arr ) {
 	return arr->byteLength;
 }
 
+/**
+* Returns the number of bytes per ndarray element.
+*
+* @param arr  input ndarray
+* @return     bytes per element
+*/
+int64_t stdlib_ndarray_byte_length_per_element( const struct ndarray *arr ) {
+	return arr->BYTES_PER_ELEMENT;
+}
+
 /**
 * Returns a pointer to an ndarray's underlying byte array.
 *