local_random is a wrapper for the standard library's <random> facilities that provides thread-local seeding and a straightforward interface suitiable for basic, non-cryptographic uses.

Mini-examples, generate a number between 0 and a maximum (inclusive):

#include "local_random"

using namespace local_random;

// ...

int x = generate_random_number(10);
float y = generate_random_number(10.0);

auto rng = random_number_generator(10);
int z = rng();

...there are plenty of things you can tune, but that's the basic idea! Each function or function object has a thread-local engine that's seeded the first time it's used. Reads from the PRNG are mutex-guarded.

Features: - self-seeding (per-thread) - thread-safe - flexible parameters - multiple interfaces (functions, classes) - straightforward use

Dependencies:

C++17

Catch2 if you want to build the tests.

To build:

No build is necessary, the library is header only.

To build examples:

cd examples make

To build tests:

The unit tests use Catch2. The Makefile looks for Catch2 in CATCH2_DIR, which defaults to "deps/Catch2/single_include" in the test directory.

A note on this project:

This is a fork of a random library developed for Ceph. I was the original designer and implementer, but this project would not have been possible without generous input from members of the Ceph community (especially Casey Bodley (@cbodley) and Adam Emerson (@adamemerson)).

I have forked this work in order to provide a standalone library suitable for uses outside of Ceph.