@stdlib/random-base 0.2.0 → 0.2.2

package/NOTICE

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

package/README.md

@@ -121,7 +121,7 @@ Attached to each PRNG are the following properties:
 -   **seed**: the value used to seed the PRNG.
 -   **seedLength**: the length of the PRNG seed.
 -   **state**: the PRNG state.
--   **stateLength**: the length  of the PRNG state.
+-   **stateLength**: the length of the PRNG state.
 -   **byteLength**: the size of the PRNG state.
 -   **PRNG**: the underlying pseudorandom number generator.
 
@@ -223,7 +223,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright © 2016-2024. The Stdlib [Authors][stdlib-authors].
+Copyright © 2016-2026. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -236,8 +236,8 @@ Copyright &copy; 2016-2024. 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.2.0
-[test-url]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml?query=branch:v0.2.0
+[test-image]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml/badge.svg?branch=v0.2.2
+[test-url]: https://github.com/stdlib-js/random-base/actions/workflows/test.yml?query=branch:v0.2.2
 
 [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
@@ -249,8 +249,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 -->
 
-[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
-[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im
+[chat-image]: https://img.shields.io/badge/zulip-join_chat-brightgreen.svg
+[chat-url]: https://stdlib.zulipchat.com
 
 [stdlib]: https://github.com/stdlib-js/stdlib
 

package/docs/types/index.d.ts

@@ -380,7 +380,7 @@ interface Namespace {
 	* // returns <number>
 	*
 	* @example
-	* var myf = ns.f.ns.factory( 1.5, 1.5 );
+	* var myf = ns.f.factory( 1.5, 1.5 );
 	*
 	* var v = myf();
 	* // returns <number>
@@ -1017,8 +1017,8 @@ interface Namespace {
 	* -   If `k <= 0` or `lambda <= 0`, the function returns `NaN`.
 	* -   If `k` or `lambda` is `NaN`, the function returns `NaN`.
 	*
-	* @param k - scale parameter
-	* @param lambda - shape parameter
+	* @param k - shape parameter
+	* @param lambda - scale parameter
 	* @returns pseudorandom number
 	*
 	* @example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/random-base",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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.2.0",
-    "@stdlib/random-base-bernoulli": "^0.2.0",
-    "@stdlib/random-base-beta": "^0.2.0",
-    "@stdlib/random-base-betaprime": "^0.2.0",
-    "@stdlib/random-base-binomial": "^0.2.0",
-    "@stdlib/random-base-box-muller": "^0.2.0",
-    "@stdlib/random-base-cauchy": "^0.2.0",
-    "@stdlib/random-base-chi": "^0.2.0",
-    "@stdlib/random-base-chisquare": "^0.2.0",
-    "@stdlib/random-base-cosine": "^0.1.0",
-    "@stdlib/random-base-discrete-uniform": "^0.2.0",
-    "@stdlib/random-base-erlang": "^0.2.0",
-    "@stdlib/random-base-exponential": "^0.2.0",
-    "@stdlib/random-base-f": "^0.2.0",
-    "@stdlib/random-base-frechet": "^0.2.0",
-    "@stdlib/random-base-gamma": "^0.1.0",
-    "@stdlib/random-base-geometric": "^0.2.0",
-    "@stdlib/random-base-gumbel": "^0.2.0",
-    "@stdlib/random-base-hypergeometric": "^0.2.0",
-    "@stdlib/random-base-improved-ziggurat": "^0.2.0",
-    "@stdlib/random-base-invgamma": "^0.2.0",
-    "@stdlib/random-base-kumaraswamy": "^0.2.0",
-    "@stdlib/random-base-laplace": "^0.2.0",
-    "@stdlib/random-base-levy": "^0.2.0",
-    "@stdlib/random-base-logistic": "^0.2.0",
-    "@stdlib/random-base-lognormal": "^0.2.0",
-    "@stdlib/random-base-minstd": "^0.2.0",
-    "@stdlib/random-base-minstd-shuffle": "^0.2.0",
-    "@stdlib/random-base-mt19937": "^0.2.0",
-    "@stdlib/random-base-negative-binomial": "^0.2.0",
-    "@stdlib/random-base-normal": "^0.2.0",
-    "@stdlib/random-base-pareto-type1": "^0.2.0",
-    "@stdlib/random-base-poisson": "^0.2.0",
-    "@stdlib/random-base-randi": "^0.2.0",
-    "@stdlib/random-base-randn": "^0.2.0",
-    "@stdlib/random-base-randu": "^0.2.0",
-    "@stdlib/random-base-rayleigh": "^0.2.0",
-    "@stdlib/random-base-reviver": "^0.1.0",
-    "@stdlib/random-base-t": "^0.2.0",
-    "@stdlib/random-base-triangular": "^0.2.0",
-    "@stdlib/random-base-uniform": "^0.2.0",
-    "@stdlib/random-base-weibull": "^0.2.0",
-    "@stdlib/utils-define-read-only-property": "^0.2.0",
-    "@stdlib/utils-library-manifest": "^0.2.0"
-  },
-  "devDependencies": {
-    "@stdlib/array-int32": "^0.2.0",
-    "@stdlib/array-to-json": "^0.2.0",
-    "@stdlib/array-uint32": "^0.2.0",
-    "@stdlib/assert-contains": "^0.2.0",
-    "@stdlib/assert-has-own-property": "^0.2.0",
-    "@stdlib/assert-is-array": "^0.2.0",
-    "@stdlib/assert-is-array-like-object": "^0.2.0",
-    "@stdlib/assert-is-boolean": "^0.2.0",
-    "@stdlib/assert-is-collection": "^0.2.0",
-    "@stdlib/assert-is-function": "^0.2.0",
-    "@stdlib/assert-is-int32array": "^0.2.0",
-    "@stdlib/assert-is-integer": "^0.2.0",
-    "@stdlib/assert-is-nan": "^0.2.0",
-    "@stdlib/assert-is-nonnegative-integer": "^0.2.0",
-    "@stdlib/assert-is-number": "^0.2.0",
-    "@stdlib/assert-is-plain-object": "^0.2.0",
-    "@stdlib/assert-is-positive-integer": "^0.2.0",
-    "@stdlib/assert-is-positive-number": "^0.2.0",
-    "@stdlib/assert-is-prng-like": "^0.2.0",
-    "@stdlib/assert-is-probability": "^0.2.0",
-    "@stdlib/assert-is-string": "^0.2.0",
-    "@stdlib/assert-is-uint32array": "^0.2.0",
-    "@stdlib/blas-base-gcopy": "^0.1.0",
-    "@stdlib/constants-float64-eps": "^0.2.0",
-    "@stdlib/constants-float64-half-pi": "^0.2.0",
-    "@stdlib/constants-float64-ln-sqrt-two-pi": "^0.2.0",
-    "@stdlib/constants-float64-max-safe-integer": "^0.2.0",
-    "@stdlib/constants-float64-pi": "^0.2.0",
-    "@stdlib/constants-float64-pinf": "^0.2.0",
-    "@stdlib/constants-float64-two-pi": "^0.2.0",
-    "@stdlib/constants-int32-max": "^0.2.0",
-    "@stdlib/constants-uint32-max": "^0.2.0",
-    "@stdlib/fs-exists": "^0.2.0",
-    "@stdlib/fs-read-dir": "^0.2.0",
-    "@stdlib/fs-write-file": "^0.2.0",
-    "@stdlib/math-base-assert-is-integer": "^0.2.0",
-    "@stdlib/math-base-assert-is-nan": "^0.2.0",
-    "@stdlib/math-base-assert-is-nonnegative-integer": "^0.2.0",
-    "@stdlib/math-base-assert-is-positive-integer": "^0.2.0",
-    "@stdlib/math-base-assert-is-probability": "^0.2.0",
-    "@stdlib/math-base-ops-umul": "^0.2.0",
-    "@stdlib/math-base-special-abs": "^0.2.0",
-    "@stdlib/math-base-special-ceil": "^0.2.0",
-    "@stdlib/math-base-special-cos": "^0.2.0",
-    "@stdlib/math-base-special-exp": "^0.2.0",
-    "@stdlib/math-base-special-factorial": "^0.2.0",
-    "@stdlib/math-base-special-factorialln": "^0.2.0",
-    "@stdlib/math-base-special-floor": "^0.2.0",
-    "@stdlib/math-base-special-ln": "^0.2.0",
-    "@stdlib/math-base-special-max": "^0.2.0",
-    "@stdlib/math-base-special-pow": "^0.2.0",
-    "@stdlib/math-base-special-round": "^0.2.0",
-    "@stdlib/math-base-special-signum": "^0.2.0",
-    "@stdlib/math-base-special-sin": "^0.2.0",
-    "@stdlib/math-base-special-sqrt": "^0.2.0",
-    "@stdlib/math-base-special-tan": "^0.2.0",
-    "@stdlib/object-assign": "^0.2.0",
-    "@stdlib/process-env": "^0.2.0",
-    "@stdlib/stats-base-dists-cosine-quantile": "^0.2.0",
-    "@stdlib/stats-base-dists-normal-quantile": "^0.2.0",
-    "@stdlib/stats-chi2gof": "^0.2.0",
-    "@stdlib/stats-kstest": "^0.2.0",
-    "@stdlib/string-format": "^0.2.0",
-    "@stdlib/time-current-year": "^0.2.0",
-    "@stdlib/time-now": "^0.2.0",
-    "@stdlib/utils-constant-function": "^0.2.0",
-    "@stdlib/utils-copy": "^0.2.0",
-    "@stdlib/utils-define-nonenumerable-read-only-accessor": "^0.2.0",
-    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.0",
-    "@stdlib/utils-define-nonenumerable-read-write-accessor": "^0.2.0",
-    "@stdlib/utils-keys": "^0.2.0",
-    "@stdlib/utils-noop": "^0.2.0",
-    "@stdlib/utils-parse-json": "^0.2.0",
-    "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.2.0",
-    "@stdlib/bench": "^0.3.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.2",
+    "@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.2"
   },
+  "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;
-}