Usage

`javascript
var minstd = require( '@stdlib/random-base-minstd-shuffle' );
`

#### minstd()

Returns a pseudorandom integer on the interval [1, 2147483646].

`javascript
var v = minstd();
// returns
`

#### minstd.normalized()

Returns a pseudorandom number on the interval [0,1).

`javascript
var v = minstd.normalized();
// returns
`

#### minstd.factory( \[options] )

Returns a linear congruential pseudorandom number generator ([LCG][lcg]) whose output is shuffled.

`javascript
var rand = minstd.factory();
`

The function accepts the following options:

- seed: pseudorandom number generator seed.
- state: an [Int32Array][@stdlib/array/int32] containing pseudorandom number generator state. If provided, the function ignores the seed option.
- copy: boolean indicating whether to copy a provided pseudorandom number generator state. Setting this option to false allows sharing state between two or more pseudorandom number generators. Setting this option to true ensures that a returned generator has exclusive control over its internal state. Default: true.

By default, a random integer is used to seed the returned generator. To seed the generator, provide either an integer on the interval [1, 2147483646]

`javascript
var rand = minstd.factory({
'seed': 1234
});

var v = rand();
// returns 1421600654
`

or, for arbitrary length seeds, an array-like object containing signed 32-bit integers

`javascript
var Int32Array = require( '@stdlib/array-int32' );

var rand = minstd.factory({
'seed': new Int32Array( [ 1234 ] )
});

var r = rand();
// returns 1421600654
`

To return a generator having a specific initial state, set the generator state option.

`javascript
// Generate pseudorandom numbers, thus progressing the generator state:
var r;
var i;
for ( i = 0; i < 1000; i++ ) {
r = minstd();
}

// Create a new PRNG initialized to the current state of minstd:
var rand = minstd.factory({
'state': minstd.state
});

// Test that the generated pseudorandom numbers are the same:
var bool = ( rand() === minstd() );
// returns true
`

#### minstd.NAME

The generator name.

`javascript
var str = minstd.NAME;
// returns 'minstd-shuffle'
`

#### minstd.MIN

Minimum possible value.

`javascript
var min = minstd.MIN;
// returns 1
`

#### minstd.MAX

Maximum possible value.

`javascript
var max = minstd.MAX;
// returns 2147483646
`

#### minstd.seed

The value used to seed minstd().

`javascript
// Generate pseudorandom values...
var v;
var i;
for ( i = 0; i < 100; i++ ) {
v = minstd();
}

// Generate the same pseudorandom values...
var rand = minstd.factory({
'seed': minstd.seed
});
for ( i = 0; i < 100; i++ ) {
v = rand();
}
`

#### minstd.seedLength

Length of generator seed.

`javascript
var len = minstd.seedLength;
// returns
`

#### minstd.state

Writable property for getting and setting the generator state.

`javascript
var r = minstd();
// returns

r = minstd();
// returns

// ...

// Get a copy of the current state:
var state = minstd.state;
// returns

r = minstd();
// returns

r = minstd();
// returns

// Reset the state:
minstd.state = state;

// Replay the last two pseudorandom numbers:
r = minstd();
// returns

r = minstd();
// returns

// ...
`

#### minstd.stateLength

Length of generator state.

`javascript
var len = minstd.stateLength;
// returns
`

#### minstd.byteLength

Size (in bytes) of generator state.

`javascript
var sz = minstd.byteLength;
// returns
`

#### minstd.toJSON()

Serializes the pseudorandom number generator as a JSON object.

`javascript
var o = minstd.toJSON();
// returns { 'type': 'PRNG', 'name': '...', 'state': {...}, 'params': [] }
`