feat: add math/base/special/frexpf

---
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/frexpf/README.md

@@ -18,24 +18,24 @@ limitations under the License.
 
 -->
 
-# frexp
+# frexpf
 
-> Split a [double-precision floating-point number][ieee754] into a normalized fraction and an integer power of two.
+> Split a [single-precision floating-point number][ieee754] into a normalized fraction and an integer power of two.
 
 <section class="usage">
 
 ## Usage
 
 ```javascript
-var frexp = require( '@stdlib/math/base/special/frexp' );
+var frexpf = require( '@stdlib/math/base/special/frexpf' );
 ```
 
-#### frexp( x )
+#### frexpf( x )
 
-Splits a [double-precision floating-point number][ieee754] into a normalized fraction and an integer power of two.
+Splits a [single-precision floating-point number][ieee754] into a normalized fraction and an integer power of two.
 
 ```javascript
-var out = frexp( 4.0 );
+var out = frexpf( 4.0 );
 // returns [ 0.5, 3 ]
 ```
 
@@ -45,7 +45,7 @@ By default, the function returns the normalized fraction and the exponent as a t
 var pow = require( '@stdlib/math/base/special/pow' );
 
 var x = 4.0;
-var out = frexp( x );
+var out = frexpf( x );
 // returns [ 0.5, 3 ]
 
 var frac = out[ 0 ];
@@ -58,35 +58,35 @@ var bool = ( x === frac * pow(2.0, exp) );
 If provided positive or negative zero, `NaN`, or positive or negative `infinity`, the function returns a two-element `array` containing the input value and an exponent equal to `0`.
 
 ```javascript
-var out = frexp( 0.0 );
+var out = frexpf( 0.0 );
 // returns [ 0.0, 0 ]
 
-out = frexp( -0.0 );
+out = frexpf( -0.0 );
 // returns [ -0.0, 0 ]
 
-out = frexp( NaN );
+out = frexpf( NaN );
 // returns [ NaN, 0 ]
 
-out = frexp( Infinity );
+out = frexpf( Infinity );
 // returns [ Infinity, 0 ]
 
-out = frexp( -Infinity );
+out = frexpf( -Infinity );
 // returns [ -Infinity, 0 ]
 ```
 
-For all other numeric input values, the [absolute value][@stdlib/math/base/special/abs] of the normalized fraction resides on the interval `[0.5,1)`.
+For all other numeric input values, the [absolute value][@stdlib/math/base/special/absf] of the normalized fraction resides on the interval `[0.5,1)`.
 
-#### frexp.assign( x, out, stride, offset )
+#### frexpf.assign( x, out, stride, offset )
 
-Splits a [double-precision floating-point number][ieee754] into a normalized fraction and an integer power of two and assigns results to a provided output array.
+Splits a [single-precision floating-point number][ieee754] into a normalized fraction and an integer power of two and assigns results to a provided output array.
 
 ```javascript
-var Float64Array = require( '@stdlib/array/float64' );
+var Float32Array = require( '@stdlib/array/float32' );
 
-var out = new Float64Array( 2 );
+var out = new Float32Array( 2 );
 
-var y = frexp.assign( 4.0, out, 1, 0 );
-// returns <Float64Array>[ 0.5, 3 ]
+var y = frexpf.assign( 4.0, out, 1, 0 );
+// returns <Float32Array>[ 0.5, 3 ]
 
 var bool = ( y === out );
 // returns true
@@ -100,23 +100,24 @@ var bool = ( y === out );
 
 ## Notes
 
--   Care should be taken when reconstituting a [double-precision floating-point number][ieee754] from a normalized fraction and an exponent. For example,
+-   Care should be taken when reconstituting a [single-precision floating-point number][ieee754] from a normalized fraction and an exponent. For example,
 
     ```javascript
     var pow = require( '@stdlib/math/base/special/pow' );
+    var f32 = require( '@stdlib/number/float64/base/to-float32' );
 
-    var x = 8.988939926493918e+307; // x ~ 2^1023
+    var x = 1.7014118346046923e+38; // x ~ 2^127
 
-    var out = frexp( x );
-    // returns [ 0.5000263811533315, 1024 ]
+    var out = frexpf( x );
+    // returns [ 0.5, 128 ]
 
     // Naive reconstitution:
-    var y = out[ 0 ] * pow( 2.0, out[ 1 ] );
+    var y = f32( out[ 0 ] * f32( pow( 2.0, out[ 1 ] ) ) );
     // returns Infinity
 
-    // Account for 2^1024 evaluating as infinity by recognizing 2^1024 = 2^1 * 2^1023:
-    y = out[ 0 ] * pow( 2.0, out[1]-1023 ) * pow( 2.0, 1023 );
-    // returns 8.988939926493918e+307
+    // Account for 2^128 evaluating as infinity by recognizing 2^128 = 2^1 * 2^127:
+    y = f32( out[ 0 ] * f32( pow( 2.0, out[1]-127 ) ) * f32( pow( 2.0, 127 ) ) );
+    // returns 1.7014118346046923e+38
     ```
 
 </section>
@@ -131,10 +132,11 @@ var bool = ( y === out );
 
 ```javascript
 var randu = require( '@stdlib/random/base/randu' );
-var round = require( '@stdlib/math/base/special/round' );
+var roundf = require( '@stdlib/math/base/special/roundf' );
 var pow = require( '@stdlib/math/base/special/pow' );
-var BIAS = require( '@stdlib/constants/float64/exponent-bias' );
-var frexp = require( '@stdlib/math/base/special/frexp' );
+var f32 = require( '@stdlib/number/float64/base/to-float32' );
+var BIAS = require( '@stdlib/constants/float32/exponent-bias' );
+var frexpf = require( '@stdlib/math/base/special/frexpf' );
 
 var sign;
 var frac;
@@ -147,18 +149,18 @@ var i;
 // Generate random numbers and break each into a normalized fraction and an integer power of two...
 for ( i = 0; i < 100; i++ ) {
     if ( randu() < 0.5 ) {
-        sign = -1.0;
+        sign = f32( -1.0 );
     } else {
-        sign = 1.0;
+        sign = f32( 1.0 );
     }
-    frac = randu() * 10.0;
-    exp = round( randu()*616.0 ) - 308;
-    x = sign * frac * pow( 10.0, exp );
-    f = frexp( x );
+    frac = f32( randu()*10.0 );
+    exp = roundf( randu()*76.0 ) - 38;
+    x = f32( sign * frac * f32( pow( 10.0, exp ) ) );
+    f = frexpf( x );
     if ( f[ 1 ] > BIAS ) {
-        v = f[ 0 ] * pow( 2.0, f[1]-BIAS ) * pow( 2.0, BIAS );
+        v = f32( f[ 0 ] * f32( pow(2.0, f[1]-BIAS) ) * f32( pow(2.0, BIAS) ) );
     } else {
-        v = f[ 0 ] * pow( 2.0, f[ 1 ] );
+        v = f32( f[ 0 ] * f32( pow( 2.0, f[ 1 ] ) ) );
     }
     console.log( '%d = %d * 2^%d = %d', x, f[ 0 ], f[ 1 ], v );
 }
@@ -191,29 +193,29 @@ for ( i = 0; i < 100; i++ ) {
 ### Usage
 
 ```c
-#include "stdlib/math/base/special/frexp.h"
+#include "stdlib/math/base/special/frexpf.h"
 ```
 
-#### stdlib_base_frexp( x, frac, exp )
+#### stdlib_base_frexpf( x, frac, exp )
 
-Splits a [double-precision floating-point number][ieee754] into a normalized fraction and an integer power of two.
+Splits a [single-precision floating-point number][ieee754] into a normalized fraction and an integer power of two.
 
 ```c
 #include <stdint.h>
 
-double frac;
+float frac;
 int32_t exp;
-stdlib_base_frexp( 4.0, &frac, &exp );
+stdlib_base_frexpf( 4.0f, &frac, &exp );
 ```
 
 The function accepts the following arguments:
 
--   **x**: `[in] double` input value.
--   **frac**: `[out] double*` destination for the normalized fraction.
+-   **x**: `[in] float` input value.
+-   **frac**: `[out] float*` destination for the normalized fraction.
 -   **exp**: `[out] int32_t*` destination for the integer power of two.
 
 ```c
-void stdlib_base_frexp( const double x, double *frac, int32_t *exp );
+void stdlib_base_frexpf( const float x, float *frac, int32_t *exp );
 ```
 
 </section>
@@ -235,19 +237,19 @@ void stdlib_base_frexp( const double x, double *frac, int32_t *exp );
 ### Examples
 
 ```c
-#include "stdlib/math/base/special/frexp.h"
+#include "stdlib/math/base/special/frexpf.h"
 #include <stdint.h>
 #include <stdio.h>
 #include <inttypes.h>
 
 int main( void ) {
-    const double x[] = { 4.0, 0.0, -0.0, 1.0, -1.0, 3.14, -3.14, 1.0e308, -1.0e308, 1.0/0.0, -1.0/0.0, 0.0/0.0 };
+    const float x[] = { 4.0f, 0.0f, -0.0f, 1.0f, -1.0f, 3.14f, -3.14f, 1.0e38f, -1.0e38f, 1.0f/0.0f, -1.0f/0.0f, 0.0f/0.0f };
 
-    double frac;
+    float frac;
     int32_t exp;
     int i;
     for ( i = 0; i < 12; i++ ) {
-        stdlib_base_frexp( x[i], &frac, &exp );
+        stdlib_base_frexpf( x[i], &frac, &exp );
         printf( "x: %f => frac: %f, exp: %" PRId32 "\n", x[i], frac, exp );
     }
 }
@@ -265,12 +267,6 @@ int main( void ) {
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/math/base/special/ldexp`][@stdlib/math/base/special/ldexp]</span><span class="delimiter">: </span><span class="description">multiply a double-precision floating-point number by an integer power of two.</span>
-
 </section>
 
 <!-- /.related -->
@@ -281,12 +277,10 @@ int main( void ) {
 
 [ieee754]: https://en.wikipedia.org/wiki/IEEE_754-1985
 
-[@stdlib/math/base/special/abs]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/abs
+[@stdlib/math/base/special/absf]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/absf
 
 <!-- <related-links> -->
 
-[@stdlib/math/base/special/ldexp]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ldexp
-
 <!-- </related-links> -->
 
 </section>

lib/node_modules/@stdlib/math/base/special/frexpf/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.
@@ -21,10 +21,10 @@
 // MODULES //
 
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
+var uniform = require( '@stdlib/random/array/uniform' );
 var isArray = require( '@stdlib/assert/is-array' );
 var pkg = require( './../package.json' ).name;
-var frexp = require( './../lib' );
+var frexpf = require( './../lib' );
 
 
 // MAIN //
@@ -34,11 +34,14 @@ bench( pkg, function benchmark( b ) {
 	var y;
 	var i;
 
+	x = uniform( 100, -5.0e6, 5.0e6, {
+		'dtype': 'float32'
+	});
+
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu()*1.0e7 ) - 5.0e6;
-		y = frexp( x );
-		if ( typeof out !== 'object' ) {
+		y = frexpf( x[ i%x.length ] );
+		if ( typeof y !== 'object' ) {
 			b.fail( 'should return an array' );
 		}
 	}
@@ -57,11 +60,13 @@ bench( pkg+':assign', function benchmark( b ) {
 	var i;
 
 	out = [ 0.0, 0.0 ];
+	x = uniform( 100, -5.0e6, 5.0e6, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu()*1.0e7 ) - 5.0e6;
-		y = frexp.assign( x, out, 1, 0 );
+		y = frexpf.assign( x[ i%x.length ], out, 1, 0 );
 		if ( typeof out !== 'object' ) {
 			b.fail( 'should return an array' );
 		}

lib/node_modules/@stdlib/math/base/special/frexpf/benchmark/benchmark.native.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,17 +22,17 @@
 
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
-var isArray = require( '@stdlib/assert/is-array' );
+var uniform = require( '@stdlib/random/array/uniform' );
+var isFloat32Array = require( '@stdlib/assert/is-float32array' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
 
 // VARIABLES //
 
-var frexp = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var frexpf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
 var opts = {
-	'skip': ( frexp instanceof Error )
+	'skip': ( frexpf instanceof Error )
 };
 
 
@@ -43,16 +43,19 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var y;
 	var i;
 
+	x = uniform( 100, -5.0e6, 5.0e6, {
+		'dtype': 'float32'
+	});
+
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu()*1.0e7 ) - 5.0e6;
-		y = frexp( x );
+		y = frexpf( x[ i%x.length ] );
 		if ( typeof y !== 'object' ) {
 			b.fail( 'should return an array' );
 		}
 	}
 	b.toc();
-	if ( !isArray( y ) ) {
+	if ( !isFloat32Array( y ) ) {
 		b.fail( 'should return an array' );
 	}
 	b.pass( 'benchmark finished' );

lib/node_modules/@stdlib/math/base/special/frexpf/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