feat: add math/base/special/sinf

---
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/sinf/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.
@@ -20,28 +20,28 @@ limitations under the License.
 
 # Sine
 
-> Compute the [sine][sine] of a number.
+> Compute the [sine][sine] of a single-precision floating-point number (in radians).
 
 <section class="usage">
 
 ## Usage
 
 ```javascript
-var sin = require( '@stdlib/math/base/special/sin' );
+var sinf = require( '@stdlib/math/base/special/sinf' );
 ```
 
-#### sin( x )
+#### sinf( x )
 
-Computes the [sine][sine] of a `number` (in radians).
+Computes the [sine][sine] of a single-precision floating-point number (in radians).
 
 ```javascript
-var v = sin( 0.0 );
+var v = sinf( 0.0 );
 // returns ~0.0
 
-v = sin( 3.141592653589793/2.0 );
+v = sinf( 3.141592653589793/2.0 );
 // returns ~1.0
 
-v = sin( -3.141592653589793/6.0 );
+v = sinf( -3.141592653589793/6.0 );
 // returns ~-0.5
 ```
 
@@ -58,15 +58,15 @@ v = sin( -3.141592653589793/6.0 );
 ```javascript
 var uniform = require( '@stdlib/random/array/uniform' );
 var logEachMap = require( '@stdlib/console/log-each-map' );
-var TWO_PI = require( '@stdlib/constants/float64/two-pi' );
-var sin = require( '@stdlib/math/base/special/sin' );
+var TWO_PI = require( '@stdlib/constants/float32/two-pi' );
+var sinf = require( '@stdlib/math/base/special/sinf' );
 
 var opts = {
-    'dtype': 'float64'
+    'dtype': 'float32'
 };
 var x = uniform( 100, 0.0, TWO_PI, opts );
 
-logEachMap( 'sin(%0.4f) = %0.4f', x, sin );
+logEachMap( 'sinf(%0.4f) = %0.4f', x, sinf );
 ```
 
 </section>
@@ -96,24 +96,24 @@ logEachMap( 'sin(%0.4f) = %0.4f', x, sin );
 ### Usage
 
 ```c
-#include "stdlib/math/base/special/sin.h"
+#include "stdlib/math/base/special/sinf.h"
 ```
 
-#### stdlib_base_sin( x )
+#### stdlib_base_sinf( x )
 
-Computes the [sine][sine] of a `number` (in radians).
+Computes the [sine][sine] of a single-precision floating-point number (in radians).
 
 ```c
-double y = stdlib_base_sin( 3.141592653589793 / 2.0 );
-// returns ~1.0
+float y = stdlib_base_sinf( 3.141592653589793f / 2.0f );
+// returns ~1.0f
 ```
 
 The function accepts the following arguments:
 
--   **x**: `[in] double` input value.
+-   **x**: `[in] float` input value.
 
 ```c
-double stdlib_base_sin( const double x );
+float stdlib_base_sinf( const float x );
 ```
 
 </section>
@@ -135,17 +135,17 @@ double stdlib_base_sin( const double x );
 ### Examples
 
 ```c
-#include "stdlib/math/base/special/sin.h"
+#include "stdlib/math/base/special/sinf.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_sin( x[ i ] );
-        printf( "sin(%lf) = %lf\n", x[ i ], y );
+        y = stdlib_base_sinf( x[ i ] );
+        printf( "sinf(%f) = %f\n", x[ i ], y );
     }
 }
 ```
@@ -162,14 +162,6 @@ int main( void ) {
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/math/base/special/cos`][@stdlib/math/base/special/cos]</span><span class="delimiter">: </span><span class="description">compute the cosine of a number.</span>
--   <span class="package-name">[`@stdlib/math/base/special/sinpi`][@stdlib/math/base/special/sinpi]</span><span class="delimiter">: </span><span class="description">compute sin(πx).</span>
--   <span class="package-name">[`@stdlib/math/base/special/tan`][@stdlib/math/base/special/tan]</span><span class="delimiter">: </span><span class="description">evaluate the tangent of a number.</span>
-
 </section>
 
 <!-- /.related -->
@@ -182,12 +174,6 @@ int main( void ) {
 
 <!-- <related-links> -->
 
-[@stdlib/math/base/special/cos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/cos
-
-[@stdlib/math/base/special/sinpi]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/sinpi
-
-[@stdlib/math/base/special/tan]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/tan
-
 <!-- </related-links> -->
 
 </section>

lib/node_modules/@stdlib/math/base/special/sinf/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 sin = require( './../lib' );
+var sinf = require( './../lib' );
 
 
 // MAIN //
@@ -34,39 +34,19 @@ bench( pkg, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -10.0, 10.0 );
+	x = uniform( 100, -10.0, 10.0, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = sin( x[ i%x.length ] );
-		if ( isnan( y ) ) {
+		y = sinf( x[ i%x.length ] );
+		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}
 	}
 	b.toc();
-	if ( isnan( y ) ) {
-		b.fail( 'should not return NaN' );
-	}
-	b.pass( 'benchmark finished' );
-	b.end();
-});
-
-bench( pkg+'::built-in', function benchmark( b ) {
-	var x;
-	var y;
-	var i;
-
-	x = uniform( 100, -10.0, 10.0 );
-
-	b.tic();
-	for ( i = 0; i < b.iterations; i++ ) {
-		y = Math.sin( x[ i%x.length ] ); // eslint-disable-line stdlib/no-builtin-math
-		if ( isnan( 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/sinf/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 sin = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var sinf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
 var opts = {
-	'skip': ( sin instanceof Error )
+	'skip': ( sinf instanceof Error )
 };
 
 
@@ -43,17 +43,19 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -10.0, 10.0 );
+	x = uniform( 100, -10.0, 10.0, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = sin( x[ i%x.length ] );
-		if ( isnan( y ) ) {
+		y = sinf( 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/sinf/benchmark/c/Makefile

@@ -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.
@@ -16,7 +16,6 @@
 # limitations under the License.
 #/
 
-
 # VARIABLES #
 
 ifndef VERBOSE

lib/node_modules/@stdlib/math/base/special/sinf/benchmark/c/benchmark.c

@@ -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,7 +22,7 @@
 #include <time.h>
 #include <sys/time.h>
 
-#define NAME "sin"
+#define NAME "sinf"
 #define ITERATIONS 1000000
 #define REPEATS 3
 
@@ -78,9 +78,9 @@ static double tic( void ) {
 *
 * @return random number
 */
-static double rand_double( void ) {
+static float rand_float( void ) {
 	int r = rand();
-	return (double)r / ( (double)RAND_MAX + 1.0 );
+	return (float)r / ( (float)RAND_MAX + 1.0f );
 }
 
 /**
@@ -89,19 +89,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 ] = ( 20.0*rand_double() ) - 10.0;
+		x[ i ] = ( 20.0f*rand_float() ) - 10.0f;
 	}
 
 	t = tic();
 	for ( i = 0; i < ITERATIONS; i++ ) {
-		y = sin( x[ i%100 ] );
+		y = sinf( x[ i%100 ] );
 		if ( y != y ) {
 			printf( "should not return NaN\n" );
 			break;