README.md

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