arc4random

arc4random
==========

Native bindings for the arc4random() family of funcitons:

* arc4random()
* arc4random_buf(buf, nbytes)
* arc4random_uniform(upper_bound)

Requirements
------------

* nodejs or iojs
* Operating system with a native arc4random() function or libbsd:
* Mac OS X (darwin)
* FreeBSD
* OpenBSD
* NetBSD
* Linux via libbsd

Installation
------------

The latest and greatest version of this software is available through npm.

npm install arc4random

Usage
-----

const rng = require('arc4random');

// returns an integer in the range 0, 2^32)
const randomNumber = rng.arc4random();

// stores nbytes integers in the given buffer.
// each byte is an integer in the range [0, 256)
const nbytes = 255;
const buf = Buffer.alloc(nbytes);
rng.arc4random_buf(buf, nbytes);

// returns an integer in the range [0, upper_bound)
const anotherRandomNumber = rng.arc4random_uniform(16);

License
-------

See [LICENSE.md