feat: add math/base/special/sinpif

---
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: passed
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: passed
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: passed
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - task: lint_c_examples
    status: passed
  - 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: passed
  - task: lint_license_headers
    status: passed
---

Author: anandkaranubc

lib/node_modules/@stdlib/math/base/special/sinpif/README.md

@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2018 The Stdlib Authors.
+Copyright (c) 2025 The Stdlib Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -18,33 +18,33 @@ limitations under the License.
 
 -->
 
-# sinpi
+# sinpif
 
-> Compute the [sine][@stdlib/math/base/special/sin] of a number times [π][@stdlib/constants/float64/pi].
+> Compute the [sine][@stdlib/math/base/special/sinf] of a number times [π][@stdlib/constants/float32/pi].
 
 <section class="usage">
 
 ## Usage
 
 ```javascript
-var sinpi = require( '@stdlib/math/base/special/sinpi' );
+var sinpif = require( '@stdlib/math/base/special/sinpif' );
 ```
 
-#### sinpi( x )
+#### sinpif( x )
 
-Computes `sin(πx)` more accurately than `sin(pi*x)`, especially for large `x`.
+Computes `sin(πx)` in single-precision floating-point format more accurately than `sin(pi*x)`, especially for large `x`.
 
 ```javascript
-var y = sinpi( 0.0 );
+var y = sinpif( 0.0 );
 // returns 0.0
 
-y = sinpi( 0.5 );
+y = sinpif( 0.5 );
 // returns 1.0
 
-y = sinpi( 0.9 );
+y = sinpif( 0.9 );
 // returns ~0.309
 
-y = sinpi( NaN );
+y = sinpif( NaN );
 // returns NaN
 ```
 
@@ -61,14 +61,14 @@ y = sinpi( NaN );
 ```javascript
 var uniform = require( '@stdlib/random/array/uniform' );
 var logEachMap = require( '@stdlib/console/log-each-map' );
-var sinpi = require( '@stdlib/math/base/special/sinpi' );
+var sinpif = require( '@stdlib/math/base/special/sinpif' );
 
 var opts = {
-    'dtype': 'float64'
+    'dtype': 'float32'
 };
 var x = uniform( 100, -100.0, 100.0, opts );
 
-logEachMap( 'sin( π * %0.4f ) = %0.4f', x, sinpi );
+logEachMap( 'sin( π * %0.4f ) = %0.4f', x, sinpif );
 ```
 
 </section>
@@ -98,24 +98,24 @@ logEachMap( 'sin( π * %0.4f ) = %0.4f', x, sinpi );
 ### Usage
 
 ```c
-#include "stdlib/math/base/special/sinpi.h"
+#include "stdlib/math/base/special/sinpif.h"
 ```
 
-#### stdlib_base_sinpi( x )
+#### stdlib_base_sinpif( x )
 
-Computes `sin(πx)` more accurately than `sin(pi*x)`, especially for large `x`.
+Computes `sin(πx)` in single-precision floating-point format more accurately than `sin(pi*x)`, especially for large `x`.
 
 ```c
-double y = stdlib_base_sinpi( 0.5 );
-// returns 1.0
+float y = stdlib_base_sinpif( 0.5f );
+// returns 1.0f
 ```
 
 The function accepts the following arguments:
 
--   **x**: `[in] double` input value.
+-   **x**: `[in] float` input value.
 
 ```c
-double stdlib_base_sinpi( const double x );
+float stdlib_base_sinpif( const float x );
 ```
 
 </section>
@@ -137,17 +137,17 @@ double stdlib_base_sinpi( const double x );
 ### Examples
 
 ```c
-#include "stdlib/math/base/special/sinpi.h"
+#include "stdlib/math/base/special/sinpif.h"
 #include <stdio.h>
 
 int main( void ) {
-    const double x[] = { 0.0, 0.523, 0.785, 1.047, 3.14 };
+    const float x[] = { 0.0f, 0.523f, 0.785f, 1.047f, 3.14f };
 
-    double y;
+    float y;
     int i;
     for ( i = 0; i < 5; i++ ) {
-        y = stdlib_base_sinpi( x[ i ] );
-        printf( "sinpi(%lf) = %lf\n", x[ i ], y );
+        y = stdlib_base_sinpif( x[ i ] );
+        printf( "sin( π * %f ) = %f\n", x[ i ], y );
     }
 }
 ```
@@ -164,12 +164,6 @@ int main( void ) {
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/math/base/special/sin`][@stdlib/math/base/special/sin]</span><span class="delimiter">: </span><span class="description">compute the sine of a number.</span>
-
 </section>
 
 <!-- /.related -->
@@ -178,11 +172,11 @@ int main( void ) {
 
 <section class="links">
 
-[@stdlib/constants/float64/pi]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/constants/float64/pi
+[@stdlib/math/base/special/sinf]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/sinf
 
-<!-- <related-links> -->
+[@stdlib/constants/float32/pi]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/constants/float32/pi
 
-[@stdlib/math/base/special/sin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/sin
+<!-- <related-links> -->
 
 <!-- </related-links> -->
 

lib/node_modules/@stdlib/math/base/special/sinpif/benchmark/benchmark.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2018 The Stdlib Authors.
+* Copyright (c) 2025 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -22,9 +22,9 @@
 
 var bench = require( '@stdlib/bench' );
 var uniform = require( '@stdlib/random/array/uniform' );
-var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
 var pkg = require( './../package.json' ).name;
-var sinpi = require( './../lib' );
+var sinpif = require( './../lib' );
 
 
 // MAIN //
@@ -34,17 +34,19 @@ bench( pkg, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -5.0e6, 5.0e6 );
+	x = uniform( 100, -5.0e6, 5.0e6, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = sinpi( x[ i%x.length ] );
-		if ( isnan( y ) ) {
+		y = sinpif( x[ i%x.length ] );
+		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}
 	}
 	b.toc();
-	if ( isnan( y ) ) {
+	if ( isnanf( y ) ) {
 		b.fail( 'should not return NaN' );
 	}
 	b.pass( 'benchmark finished' );

lib/node_modules/@stdlib/math/base/special/sinpif/benchmark/benchmark.native.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 The Stdlib Authors.
+* Copyright (c) 2025 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,16 +23,16 @@
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
 var uniform = require( '@stdlib/random/array/uniform' );
-var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
 
 // VARIABLES //
 
-var sinpi = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var sinpif = tryRequire( resolve( __dirname, './../lib/native.js' ) );
 var opts = {
-	'skip': ( sinpi instanceof Error )
+	'skip': ( sinpif instanceof Error )
 };
 
 
@@ -43,17 +43,19 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -5.0e6, 5.0e6 );
+	x = uniform( 100, -5.0e6, 5.0e6, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = sinpi( x[ i%x.length ] );
-		if ( isnan( y ) ) {
+		y = sinpif( x[ i%x.length ] );
+		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}
 	}
 	b.toc();
-	if ( isnan( y ) ) {
+	if ( isnanf( y ) ) {
 		b.fail( 'should not return NaN' );
 	}
 	b.pass( 'benchmark finished' );

lib/node_modules/@stdlib/math/base/special/sinpif/benchmark/c/native/Makefile

@@ -1,7 +1,7 @@
 #/
 # @license Apache-2.0
 #
-# Copyright (c) 2024 The Stdlib Authors.
+# Copyright (c) 2025 The Stdlib Authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

lib/node_modules/@stdlib/math/base/special/sinpif/benchmark/c/native/benchmark.c

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 The Stdlib Authors.
+* Copyright (c) 2025 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -16,14 +16,14 @@
 * limitations under the License.
 */
 
-#include "stdlib/math/base/special/sinpi.h"
+#include "stdlib/math/base/special/sinpif.h"
 #include <stdlib.h>
 #include <stdio.h>
 #include <math.h>
 #include <time.h>
 #include <sys/time.h>
 
-#define NAME "sinpi"
+#define NAME "sinpif"
 #define ITERATIONS 1000000
 #define REPEATS 3
 
@@ -75,13 +75,15 @@ static double tic( void ) {
 }
 
 /**
-* Generates a random number on the interval [0,1).
+* Generates a random number on the interval [min,max).
 *
-* @return random number
+* @param min    minimum value (inclusive)
+* @param max    maximum value (exclusive)
+* @return       random number
 */
-static double rand_double( void ) {
-	int r = rand();
-	return (double)r / ( (double)RAND_MAX + 1.0 );
+static float random_uniform( const float min, const float max ) {
+	float v = (float)rand() / ( (float)RAND_MAX + 1.0f );
+	return min + ( v*(max-min) );
 }
 
 /**
@@ -90,19 +92,19 @@ static double rand_double( void ) {
 * @return elapsed time in seconds
 */
 static double benchmark( void ) {
-	double x[ 100 ];
+	float x[ 100 ];
 	double elapsed;
-	double y;
 	double t;
+	float y;
 	int i;
 
 	for ( i = 0; i < 100; i++ ) {
-		x[ i ] = ( 1.0e7 * rand_double() ) - 5.0e6;
+		x[ i ] = random_uniform( -5.0e6, 5.0e6 );
 	}
 
 	t = tic();
 	for ( i = 0; i < ITERATIONS; i++ ) {
-		y = stdlib_base_sinpi( x[ i%100 ] );
+		y = stdlib_base_sinpif( x[ i%100 ] );
 		if ( y != y ) {
 			printf( "should not return NaN\n" );
 			break;