@stdlib/random-base 0.1.1 → 0.2.1

package/LICENSE

@@ -181,32 +181,6 @@ The library links against the following external libraries or contains
 implementations from the following external libraries, which have their own
 licenses:
 
-* Boost <http://www.boost.org/LICENSE_1_0.txt>
-
-Boost Software License - Version 1.0 - August 17th, 2003
-
-Permission is hereby granted, free of charge, to any person or organization
-obtaining a copy of the software and accompanying documentation covered by
-this license (the "Software") to use, reproduce, display, distribute,
-execute, and transmit the Software, and to prepare derivative works of the
-Software, and to permit third-parties to whom the Software is furnished to
-do so, all subject to the following:
-
-The copyright notices in the Software and this entire statement, including
-the above license grant, this restriction and the following disclaimer,
-must be included in all copies of the Software, in whole or in part, and
-all derivative works of the Software, unless such copies or derivative
-works are solely in the form of machine-executable object code generated by
-a source language processor.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
-SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
-FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
-ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-
 * MT19937 <http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/CODES/
 mt19937ar.c>
 
@@ -240,3 +214,29 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+* Boost <http://www.boost.org/LICENSE_1_0.txt>
+
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+

package/NOTICE

@@ -1 +1 @@
-Copyright (c) 2016-2023 The Stdlib Authors.
+Copyright (c) 2016-2024 The Stdlib Authors.

package/README.md

@@ -223,7 +223,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright © 2016-2023. The Stdlib [Authors][stdlib-authors].
+Copyright © 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -236,8 +236,8 @@ Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/random-base.svg
 [npm-url]: https://npmjs.org/package/@stdlib/random-base
 
-[test-image]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml/badge.svg?branch=v0.1.1
-[test-url]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml?query=branch:v0.1.1
+[test-image]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml/badge.svg?branch=v0.2.1
+[test-url]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml?query=branch:v0.2.1
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/random-base/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/random-base?branch=main
@@ -260,8 +260,11 @@ Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 [es-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules
 
 [deno-url]: https://github.com/stdlib-js/random-base/tree/deno
+[deno-readme]: https://github.com/stdlib-js/random-base/blob/deno/README.md
 [umd-url]: https://github.com/stdlib-js/random-base/tree/umd
+[umd-readme]: https://github.com/stdlib-js/random-base/blob/umd/README.md
 [esm-url]: https://github.com/stdlib-js/random-base/tree/esm
+[esm-readme]: https://github.com/stdlib-js/random-base/blob/esm/README.md
 [branches-url]: https://github.com/stdlib-js/random-base/blob/main/branches.md
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/random-base/main/LICENSE

package/docs/types/index.d.ts

@@ -927,8 +927,8 @@ interface Namespace {
 	* @returns value or PRNG
 	*
 	* @example
-	* var parseJSON = require( `@stdlib/utils/parse-json` );
-	* var mt19937 = require( `@stdlib/random/base/mt19937` );
+	* var parseJSON = require( '@stdlib/utils-parse-json' );
+	* var mt19937 = require( '@stdlib/random-base-mt19937' );
 	*
 	* var str = JSON.stringify( mt19937 );
 	* var rand = parseJSON( str, ns.reviveBasePRNG );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/random-base",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Base pseudorandom number generators.",
   "license": "Apache-2.0",
   "author": {
@@ -15,21 +15,12 @@
   ],
   "main": "./lib",
   "directories": {
-    "benchmark": "./benchmark",
     "doc": "./docs",
-    "example": "./examples",
-    "include": "./include",
     "lib": "./lib",
-    "src": "./src",
-    "test": "./test"
+    "dist": "./dist"
   },
   "types": "./docs/types",
-  "scripts": {
-    "test": "make test",
-    "test-cov": "make test-cov",
-    "examples": "make examples",
-    "benchmark": "make benchmark"
-  },
+  "scripts": {},
   "homepage": "https://stdlib.io",
   "repository": {
     "type": "git",
@@ -39,132 +30,51 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/random-base-arcsine": "^0.1.0",
-    "@stdlib/random-base-bernoulli": "^0.1.0",
-    "@stdlib/random-base-beta": "^0.1.0",
-    "@stdlib/random-base-betaprime": "^0.1.0",
-    "@stdlib/random-base-binomial": "^0.1.0",
-    "@stdlib/random-base-box-muller": "^0.1.0",
-    "@stdlib/random-base-cauchy": "^0.1.0",
-    "@stdlib/random-base-chi": "^0.1.0",
-    "@stdlib/random-base-chisquare": "^0.1.0",
-    "@stdlib/random-base-cosine": "^0.1.0",
-    "@stdlib/random-base-discrete-uniform": "^0.1.0",
-    "@stdlib/random-base-erlang": "^0.1.0",
-    "@stdlib/random-base-exponential": "^0.1.0",
-    "@stdlib/random-base-f": "^0.1.0",
-    "@stdlib/random-base-frechet": "^0.1.0",
-    "@stdlib/random-base-gamma": "^0.1.0",
-    "@stdlib/random-base-geometric": "^0.1.0",
-    "@stdlib/random-base-gumbel": "^0.1.0",
-    "@stdlib/random-base-hypergeometric": "^0.1.0",
-    "@stdlib/random-base-improved-ziggurat": "^0.1.0",
-    "@stdlib/random-base-invgamma": "^0.1.0",
-    "@stdlib/random-base-kumaraswamy": "^0.1.0",
-    "@stdlib/random-base-laplace": "^0.1.0",
-    "@stdlib/random-base-levy": "^0.1.0",
-    "@stdlib/random-base-logistic": "^0.1.0",
-    "@stdlib/random-base-lognormal": "^0.1.0",
-    "@stdlib/random-base-minstd": "^0.1.0",
-    "@stdlib/random-base-minstd-shuffle": "^0.1.0",
-    "@stdlib/random-base-mt19937": "^0.1.0",
-    "@stdlib/random-base-negative-binomial": "^0.1.0",
-    "@stdlib/random-base-normal": "^0.1.0",
-    "@stdlib/random-base-pareto-type1": "^0.1.0",
-    "@stdlib/random-base-poisson": "^0.1.0",
-    "@stdlib/random-base-randi": "^0.1.0",
-    "@stdlib/random-base-randn": "^0.1.0",
-    "@stdlib/random-base-randu": "^0.1.0",
-    "@stdlib/random-base-rayleigh": "^0.1.0",
-    "@stdlib/random-base-reviver": "^0.1.0",
-    "@stdlib/random-base-t": "^0.1.0",
-    "@stdlib/random-base-triangular": "^0.1.0",
-    "@stdlib/random-base-uniform": "^0.1.0",
-    "@stdlib/random-base-weibull": "^0.1.0",
-    "@stdlib/utils-define-read-only-property": "^0.1.1",
-    "@stdlib/utils-library-manifest": "^0.1.1"
-  },
-  "devDependencies": {
-    "@stdlib/array-int32": "^0.1.1",
-    "@stdlib/array-to-json": "^0.1.0",
-    "@stdlib/array-uint32": "^0.1.1",
-    "@stdlib/assert-contains": "^0.1.0",
-    "@stdlib/assert-has-own-property": "^0.1.1",
-    "@stdlib/assert-is-array": "^0.1.1",
-    "@stdlib/assert-is-array-like-object": "^0.1.0",
-    "@stdlib/assert-is-boolean": "^0.1.1",
-    "@stdlib/assert-is-collection": "^0.1.0",
-    "@stdlib/assert-is-function": "^0.1.1",
-    "@stdlib/assert-is-int32array": "^0.1.1",
-    "@stdlib/assert-is-integer": "^0.1.0",
-    "@stdlib/assert-is-nan": "^0.1.1",
-    "@stdlib/assert-is-nonnegative-integer": "^0.1.0",
-    "@stdlib/assert-is-number": "^0.1.1",
-    "@stdlib/assert-is-plain-object": "^0.1.1",
-    "@stdlib/assert-is-positive-integer": "^0.1.0",
-    "@stdlib/assert-is-positive-number": "^0.1.1",
-    "@stdlib/assert-is-prng-like": "^0.1.1",
-    "@stdlib/assert-is-probability": "^0.1.1",
-    "@stdlib/assert-is-string": "^0.1.1",
-    "@stdlib/assert-is-uint32array": "^0.1.1",
-    "@stdlib/blas-base-gcopy": "^0.1.0",
-    "@stdlib/constants-float64-eps": "^0.1.1",
-    "@stdlib/constants-float64-half-pi": "^0.1.1",
-    "@stdlib/constants-float64-ln-sqrt-two-pi": "^0.1.1",
-    "@stdlib/constants-float64-max-safe-integer": "^0.1.1",
-    "@stdlib/constants-float64-pi": "^0.1.1",
-    "@stdlib/constants-float64-pinf": "^0.1.1",
-    "@stdlib/constants-float64-two-pi": "^0.1.1",
-    "@stdlib/constants-int32-max": "^0.1.1",
-    "@stdlib/constants-uint32-max": "^0.1.1",
-    "@stdlib/fs-exists": "^0.1.1",
-    "@stdlib/fs-read-dir": "^0.1.1",
-    "@stdlib/fs-write-file": "^0.1.1",
-    "@stdlib/math-base-assert-is-integer": "^0.1.1",
-    "@stdlib/math-base-assert-is-nan": "^0.1.1",
-    "@stdlib/math-base-assert-is-nonnegative-integer": "^0.1.1",
-    "@stdlib/math-base-assert-is-positive-integer": "^0.1.1",
-    "@stdlib/math-base-assert-is-probability": "^0.1.1",
-    "@stdlib/math-base-ops-umul": "^0.1.1",
-    "@stdlib/math-base-special-abs": "^0.1.1",
-    "@stdlib/math-base-special-ceil": "^0.1.1",
-    "@stdlib/math-base-special-cos": "^0.1.0",
-    "@stdlib/math-base-special-exp": "^0.1.0",
-    "@stdlib/math-base-special-factorial": "^0.1.0",
-    "@stdlib/math-base-special-factorialln": "^0.1.0",
-    "@stdlib/math-base-special-floor": "^0.1.1",
-    "@stdlib/math-base-special-ln": "^0.1.1",
-    "@stdlib/math-base-special-max": "^0.1.1",
-    "@stdlib/math-base-special-pow": "^0.1.0",
-    "@stdlib/math-base-special-round": "^0.1.1",
-    "@stdlib/math-base-special-signum": "^0.1.1",
-    "@stdlib/math-base-special-sin": "^0.1.0",
-    "@stdlib/math-base-special-sqrt": "^0.1.1",
-    "@stdlib/math-base-special-tan": "^0.1.0",
-    "@stdlib/object-assign": "^0.1.0",
-    "@stdlib/process-env": "^0.1.1",
-    "@stdlib/stats-base-dists-cosine-quantile": "^0.1.0",
-    "@stdlib/stats-base-dists-normal-quantile": "^0.1.1",
-    "@stdlib/stats-chi2gof": "^0.1.0",
-    "@stdlib/stats-kstest": "^0.1.0",
-    "@stdlib/string-format": "^0.1.1",
-    "@stdlib/time-current-year": "^0.1.1",
-    "@stdlib/time-now": "^0.1.1",
-    "@stdlib/utils-constant-function": "^0.1.1",
-    "@stdlib/utils-copy": "^0.1.0",
-    "@stdlib/utils-define-nonenumerable-read-only-accessor": "^0.1.1",
-    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.1.1",
-    "@stdlib/utils-define-nonenumerable-read-write-accessor": "^0.1.1",
-    "@stdlib/utils-keys": "^0.1.0",
-    "@stdlib/utils-noop": "^0.1.1",
-    "@stdlib/utils-parse-json": "^0.1.1",
-    "proxyquire": "^2.0.0",
-    "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
-    "istanbul": "^0.4.1",
-    "tap-min": "git+https://github.com/Planeshifter/tap-min.git",
-    "@stdlib/bench-harness": "^0.1.2",
-    "@stdlib/bench": "^0.2.1"
+    "@stdlib/random-base-arcsine": "^0.2.1",
+    "@stdlib/random-base-bernoulli": "^0.2.1",
+    "@stdlib/random-base-beta": "^0.2.1",
+    "@stdlib/random-base-betaprime": "^0.2.1",
+    "@stdlib/random-base-binomial": "^0.2.1",
+    "@stdlib/random-base-box-muller": "^0.2.1",
+    "@stdlib/random-base-cauchy": "^0.2.1",
+    "@stdlib/random-base-chi": "^0.2.1",
+    "@stdlib/random-base-chisquare": "^0.2.1",
+    "@stdlib/random-base-cosine": "^0.2.1",
+    "@stdlib/random-base-discrete-uniform": "^0.2.1",
+    "@stdlib/random-base-erlang": "^0.2.1",
+    "@stdlib/random-base-exponential": "^0.2.1",
+    "@stdlib/random-base-f": "^0.2.1",
+    "@stdlib/random-base-frechet": "^0.2.1",
+    "@stdlib/random-base-gamma": "^0.2.1",
+    "@stdlib/random-base-geometric": "^0.2.1",
+    "@stdlib/random-base-gumbel": "^0.2.1",
+    "@stdlib/random-base-hypergeometric": "^0.2.1",
+    "@stdlib/random-base-improved-ziggurat": "^0.2.1",
+    "@stdlib/random-base-invgamma": "^0.2.1",
+    "@stdlib/random-base-kumaraswamy": "^0.2.1",
+    "@stdlib/random-base-laplace": "^0.2.1",
+    "@stdlib/random-base-levy": "^0.2.1",
+    "@stdlib/random-base-logistic": "^0.2.1",
+    "@stdlib/random-base-lognormal": "^0.2.1",
+    "@stdlib/random-base-minstd": "^0.2.1",
+    "@stdlib/random-base-minstd-shuffle": "^0.2.1",
+    "@stdlib/random-base-mt19937": "^0.2.1",
+    "@stdlib/random-base-negative-binomial": "^0.2.1",
+    "@stdlib/random-base-normal": "^0.2.1",
+    "@stdlib/random-base-pareto-type1": "^0.2.1",
+    "@stdlib/random-base-poisson": "^0.2.1",
+    "@stdlib/random-base-randi": "^0.2.1",
+    "@stdlib/random-base-randn": "^0.2.1",
+    "@stdlib/random-base-randu": "^0.2.1",
+    "@stdlib/random-base-rayleigh": "^0.2.1",
+    "@stdlib/random-base-reviver": "^0.2.1",
+    "@stdlib/random-base-t": "^0.2.1",
+    "@stdlib/random-base-triangular": "^0.2.1",
+    "@stdlib/random-base-uniform": "^0.2.1",
+    "@stdlib/random-base-weibull": "^0.2.1",
+    "@stdlib/utils-define-read-only-property": "^0.2.1"
   },
+  "devDependencies": {},
   "engines": {
     "node": ">=0.10.0",
     "npm": ">2.7.0"

package/include/stdlib/random/base.h

@@ -1,147 +0,0 @@
-/**
-* @license Apache-2.0
-*
-* Copyright (c) 2018 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.
-* You may obtain a copy of the License at
-*
-*    http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-
-#ifndef STDLIB_RANDOM_BASE_H
-#define STDLIB_RANDOM_BASE_H
-
-#include <stdlib.h>
-#include <stdint.h>
-
-/*
-* If C++, prevent name mangling so that the compiler emits a binary file having undecorated names, thus mirroring the behavior of a C compiler.
-*/
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// Forward declaration.
-struct BasePRNGObject;
-
-/**
-* Base PRNG structure.
-*/
-struct BasePRNG {
-	// Define the generator name:
-	const char *name;
-
-	// Define the minimum possible generated integer value:
-	const uint64_t min;
-
-	// Define the maximum possible generated integer value:
-	const uint64_t max;
-
-	// Define the minimum possible generated double-precision floating-point number:
-	const double normalized_min;
-
-	// Define the maximum possible generated double-precision floating-point number:
-	const double normalized_max;
-
-	// Define the size of the PRNG state:
-	const size_t state_size;
-
-	// Define a pointer to a function for returning the next generated value:
-	int8_t (* const next)( struct BasePRNGObject *obj, uint64_t *out );
-
-	// Define a pointer to a function for returning the next generated value on the interval `[0,1)`:
-	int8_t (* const normalized)( struct BasePRNGObject *obj, double *out );
-
-	// Define a pointer to a function for freeing a PRNG's allocated memory:
-	void (* const free)( struct BasePRNGObject *obj );
-};
-
-/**
-* Base PRNG wrapper.
-*/
-struct BasePRNGObject {
-	// Define a pointer to the underlying pseudorandom number generator:
-	const struct BasePRNG *prng;
-
-	// Define a pointer to the generator state:
-	void *state;
-};
-
-/**
-* Frees a PRNG's allocated memory.
-*/
-void stdlib_base_prng_free( struct BasePRNGObject *obj );
-
-/**
-* Returns a pseudorandom integer.
-*/
-uint64_t stdlib_base_prng_next( struct BasePRNGObject *obj );
-
-/**
-* Returns a pseudorandom double-precision floating-point number on the interval `[0,1)`.
-*/
-double stdlib_base_prng_normalized( struct BasePRNGObject *obj );
-
-/**
-* Returns a PRNG name.
-*/
-const char * stdlib_base_prng_name( const struct BasePRNGObject *obj );
-
-/**
-* Returns the minimum possible integer value generated by a provided PRNG.
-*/
-uint64_t stdlib_base_prng_min( const struct BasePRNGObject *obj );
-
-/**
-* Returns the maximum possible integer value generated by a provided PRNG.
-*/
-uint64_t stdlib_base_prng_max( const struct BasePRNGObject *obj );
-
-/**
-* Returns the minimum possible double-precision floating-point number generated by a provided PRNG.
-*/
-double stdlib_base_prng_normalized_min( const struct BasePRNGObject *obj );
-
-/**
-* Returns the maximum possible double-precision floating-point number generated by a provided PRNG.
-*/
-double stdlib_base_prng_normalized_max( const struct BasePRNGObject *obj );
-
-/**
-* Returns the size of a provided PRNG's internal state.
-*/
-size_t stdlib_base_prng_state_size( const struct BasePRNGObject *obj );
-
-/**
-* Returns a copy of a PRNG's internal state.
-*/
-void * stdlib_base_prng_state( const struct BasePRNGObject *obj );
-
-/**
-* Sets a PRNG's state.
-*/
-int8_t stdlib_base_prng_set( struct BasePRNGObject *obj, const void *vstate );
-
-/**
-* Copies a PRNG.
-*/
-struct BasePRNGObject * stdlib_base_prng_copy( const struct BasePRNGObject *src );
-
-/**
-* Copies a PRNG state from a source PRNG to a destination PRNG of the same kind.
-*/
-int8_t stdlib_base_prng_copy_state( struct BasePRNGObject *dest, const struct BasePRNGObject *src );
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // !STDLIB_RANDOM_BASE_H

package/manifest.json

@@ -1,38 +0,0 @@
-{
-	"options": {},
-	"fields": [
-		{
-			"field": "src",
-			"resolve": true,
-			"relative": true
-		},
-		{
-			"field": "include",
-			"resolve": true,
-			"relative": true
-		},
-		{
-			"field": "libraries",
-			"resolve": false,
-			"relative": false
-		},
-		{
-			"field": "libpath",
-			"resolve": true,
-			"relative": false
-		}
-	],
-	"confs": [
-		{
-			"src": [
-				"./src/main.c"
-			],
-			"include": [
-				"./include"
-			],
-			"libraries": [],
-			"libpath": [],
-			"dependencies": []
-		}
-	]
-}

package/src/main.c

@@ -1,223 +0,0 @@
-/**
-* @license Apache-2.0
-*
-* Copyright (c) 2018 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.
-* You may obtain a copy of the License at
-*
-*    http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-
-// Note: keep project includes in alphabetical order...
-#include <stdlib.h>
-#include <stdint.h>
-#include <string.h>
-#include <math.h>
-#include "stdlib/random/base.h"
-
-/**
-* Frees a PRNG's allocated memory.
-*
-* @param obj  PRNG object
-*/
-void stdlib_base_prng_free( struct BasePRNGObject *obj ) {
-	if ( obj == NULL ) {
-		return;
-	}
-	obj->prng->free( obj );
-}
-
-/**
-* Returns a pseudorandom integer.
-*
-* ## Notes
-*
-* -   The function returns `0` if provided a `NULL` pointer.
-*
-* @param obj  PRNG object
-* @return     pseudorandom integer
-*/
-uint64_t stdlib_base_prng_next( struct BasePRNGObject *obj ) {
-	if ( obj == NULL ) {
-		return 0;
-	}
-	uint64_t v;
-	obj->prng->next( obj, &v );
-	return v;
-}
-
-/**
-* Returns a pseudorandom double-precision floating-point number on the interval `[0,1)`.
-*
-* ## Notes
-*
-* -   The function returns `NAN` if provided a `NULL` pointer.
-*
-* @param obj  PRNG object
-* @return     pseudorandom number
-*/
-double stdlib_base_prng_normalized( struct BasePRNGObject *obj ) {
-	if ( obj == NULL ) {
-		return NAN;
-	}
-	double v;
-	obj->prng->normalized( obj, &v );
-	return v;
-}
-
-/**
-* Returns a PRNG name.
-*
-* @param obj  PRNG object
-* @return     PRNG name
-*/
-const char * stdlib_base_prng_name( const struct BasePRNGObject *obj ) {
-	return obj->prng->name;
-}
-
-/**
-* Returns the minimum possible integer value generated by a provided PRNG.
-*
-* @param obj  PRNG object
-* @return     minimum possible integer value
-*/
-uint64_t stdlib_base_prng_min( const struct BasePRNGObject *obj ) {
-	return (uint64_t)( obj->prng->min );
-}
-
-/**
-* Returns the maximum possible integer value generated by a provided PRNG.
-*
-* @param obj  PRNG object
-* @return     maximum possible integer value
-*/
-uint64_t stdlib_base_prng_max( const struct BasePRNGObject *obj ) {
-	return (uint64_t)( obj->prng->max );
-}
-
-/**
-* Returns the minimum possible double-precision floating-point number generated by a provided PRNG.
-*
-* @param obj  PRNG object
-* @return     minimum possible double
-*/
-double stdlib_base_prng_normalized_min( const struct BasePRNGObject *obj ) {
-	return (double)( obj->prng->normalized_min );
-}
-
-/**
-* Returns the maximum possible double-precision floating-point number generated by a provided PRNG.
-*
-* @param obj  PRNG object
-* @return     maximum possible double
-*/
-double stdlib_base_prng_normalized_max( const struct BasePRNGObject *obj ) {
-	return (double)( obj->prng->normalized_max );
-}
-
-/**
-* Returns the size of a provided PRNG's internal state.
-*
-* @param obj  PRNG object
-* @return     state size
-*/
-size_t stdlib_base_prng_state_size( const struct BasePRNGObject *obj ) {
-	return (size_t)( obj->prng->state_size );
-}
-
-/**
-* Returns a copy of a PRNG's internal state.
-*
-* ## Notes
-*
-* -   The user is responsible for freeing the allocated memory.
-*
-* @param obj  PRNG object
-* @return     pointer to a copy of a PRNG's internal state or, if unable to allocate memory, a null pointer
-*/
-void * stdlib_base_prng_state( const struct BasePRNGObject *obj ) {
-	if ( obj == NULL ) {
-		return NULL;
-	}
-	void *state = malloc( obj->prng->state_size );
-	if ( state == NULL ) {
-		return NULL;
-	}
-	memcpy( state, obj->state, obj->prng->state_size );
-	return state;
-}
-
-/**
-* Sets a PRNG's state.
-*
-* ## Notes
-*
-* -   The function returns `-1` if unable to set a PRNG state and `0` otherwise.
-*
-* @param obj    PRNG object
-* @param state  state
-* @return       status code
-*/
-int8_t stdlib_base_prng_set( struct BasePRNGObject *obj, const void *vstate ) {
-	if ( obj == NULL || vstate == NULL ) {
-		return -1;
-	}
-	memcpy( obj->state, vstate, obj->prng->state_size );
-	return 0;
-}
-
-/**
-* Copies a PRNG.
-*
-* @param src  source PRNG object
-* @return     pointer to a dynamically allocated PRNG or, if unable to allocate memory, a null pointer
-*/
-struct BasePRNGObject * stdlib_base_prng_copy( const struct BasePRNGObject *src ) {
-	struct BasePRNGObject *out = (struct BasePRNGObject *)malloc( sizeof( struct BasePRNGObject ) );
-	if ( out == NULL ) {
-		return NULL;
-	}
-	// Allocate memory for the PRNG state...
-	out->state = malloc( src->prng->state_size );
-	if ( out->state == NULL ) {
-		free( out ); // prevent memory leaks
-		return NULL;
-	}
-	// Set the PRNG (includes PRNG properties and methods):
-	out->prng = src->prng;
-
-	// Copy the current source PRNG state:
-	memcpy( out->state, src->state, src->prng->state_size );
-
-	return out;
-}
-
-/**
-* Copies a PRNG state from a source PRNG to a destination PRNG of the same kind.
-*
-* ## Notes
-*
-* -   The function returns `-1` if unable to copy a PRNG's state and `0` otherwise.
-*
-* @param dest  destination PRNG object
-* @param src   source PRNG object
-* @return      status code
-*/
-int8_t stdlib_base_prng_copy_state( struct BasePRNGObject *dest, const struct BasePRNGObject *src ) {
-	// We can only copy state between compatible PRNGs...
-	if ( dest->prng != src->prng ) {
-		return -1;
-	}
-	// Copy the current source PRNG state:
-	memcpy( dest->state, src->state, src->prng->state_size );
-
-	return 0;
-}