[utkarshpatwa393-sys]

Description

This PR adds the native C implementation for @stdlib/blas/ext/base/ndarray/scircshift (circularly shift the elements of a one-dimensional single-precision floating-point ndarray by a specified number of positions).

Part of #14819.

Changes

• Added src/main.c, src/addon.c, src/Makefile
• Added header include/stdlib/blas/ext/base/ndarray/scircshift.h
• Added manifest.json, binding.gyp, include.gypi
• Added Node-API native bridge in lib/native.js and updated lib/index.js
• Added unit tests in test/test.main.js and test/test.native.js
• Added C example in examples/c/example.c and examples/c/Makefile
• Added C and native benchmarks in benchmark/c/ (with srand seeding and TAP format) and benchmark/benchmark.native.js
• Updated README.md with C APIs documentation and usage examples
• Updated package.json with browser, gypfile, and directory mappings

Checklist

• Read, understood, and followed the contributing guidelines
• I have read and understood the Code of Conduct.
• All commits are signed off with Developer Certificate of Origin (git commit -s).

[ujjwalv01]

Suggested change

	k = scalar2ndarray( 3, {
	'dtype': 'int32'
	});

[ujjwalv01]

benchmark.native.js should be the same as benchmark.js, plus the native wiring.

Suggested change

	var resolve = require( 'path' ).resolve;
	var bench = require( '@stdlib/bench' );
	var uniform = require( '@stdlib/random/uniform' );
	var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
	var pow = require( '@stdlib/math/base/special/pow' );
	var format = require( '@stdlib/string/format' );
	var tryRequire = require( '@stdlib/utils/try-require' );
	var pkg = require( './../package.json' ).name;
	var resolve = require( 'path' ).resolve;
	var bench = require( '@stdlib/bench' );
	var uniform = require( '@stdlib/random/uniform' );
	var pow = require( '@stdlib/math/base/special/pow' );
	var format = require( '@stdlib/string/format' );
	var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
	var tryRequire = require( '@stdlib/utils/try-require' );
	var pkg = require( './../package.json' ).name;

[ujjwalv01]

Suggested change

	* @param {PositiveInteger} len - ndarray length
	* @param {PositiveInteger} len - array length

[ujjwalv01]

Suggested change

	var x = uniform( [ len ], -100.0, 100.0, options );
	var k = scalar2ndarray( 2, {
	'dtype': 'int64'
	});
	var x;
	var k;
	x = uniform( [ len ], 0.0, 100.0, options );
	k = scalar2ndarray( 3, {
	'dtype': 'int32'
	});

[ujjwalv01]

Read k as int32 (same as ztril), so no cast is needed, and read the scalar first as in the other packages.

Suggested change

	int64_t k;
	const CBLAS_INT N = stdlib_ndarray_dimension( x, 0 );
	const CBLAS_INT strideX = stdlib_ndarray_stride_elements( x, 0 );
	const CBLAS_INT offsetX = stdlib_ndarray_offset_elements( x );
	float *dataX = (float *)stdlib_ndarray_data( x );
	stdlib_ndarray_get_int64( arrays[ 1 ], NULL, &k );
	API_SUFFIX(stdlib_strided_scircshift_ndarray)( N, (CBLAS_INT)k, dataX, strideX, offsetX );
	int32_t k;
	stdlib_ndarray_get_int32( arrays[ 1 ], NULL, &k );
	const CBLAS_INT N = stdlib_ndarray_dimension( x, 0 );
	const CBLAS_INT strideX = stdlib_ndarray_stride_elements( x, 0 );
	const CBLAS_INT offsetX = stdlib_ndarray_offset_elements( x );
	float *dataX = (float *)stdlib_ndarray_data( x );
	API_SUFFIX(stdlib_strided_scircshift_ndarray)( N, k, dataX, strideX, offsetX );

[ujjwalv01]

@utkarshpatwa393-sys! Same as #16501 (dcircshift): k should be int32 throughout the package rather than converted to int64 in native.js; Please apply the same changes suggested there , here as well. Left suggestions for the files that differ here.