{{alias}}( [options] ) Create an iterator for generating pseudorandom numbers drawn from a standard normal distribution. The default underlying pseudorandom number generator (PRNG) *may* change in the future. If exact reproducibility is required, either explicitly specify a PRNG via the `name` option or use an underlying PRNG directly. If an environment supports Symbol.iterator, the returned iterator is iterable. Parameters ---------- options: Object (optional) Options. options.name: string (optional) Name of a supported pseudorandom number generator (PRNG), which will serve as the underlying source of pseudorandom numbers. The following PRNGs are supported: - improved-ziggurat: improved ziggurat method. - box-muller: Box-Muller transform. Default: `'improved-ziggurat'`. options.prng: Function (optional) Pseudorandom number generator (PRNG) for generating uniformly distributed pseudorandom numbers on the interval `[0,1)`. If provided, the `state` and `seed` options are ignored. In order to seed the returned iterator, one must seed the provided `prng` (assuming the provided `prng` is seedable). options.seed: integer|ArrayLikeObject (optional) Pseudorandom number generator seed. The seed may be either a positive unsigned 32-bit integer or, for arbitrary length seeds, an array-like object containing unsigned 32-bit integers. options.state: Uint32Array (optional) Pseudorandom number generator state. If provided, the `seed` option is ignored. options.copy: boolean (optional) 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 iterator has exclusive control over its internal state. Default: true. options.iter: integer (optional) Number of iterations. Returns ------- iterator: Object Iterator. iterator.next(): Function Returns an iterator protocol-compliant object containing the next iterated value (if one exists) and a boolean flag indicating whether the iterator is finished. iterator.return( [value] ): Function Finishes an iterator and returns a provided value. iterator.PRNG: Function Underlying pseudorandom number generator. iterator.seed: Uint32Array|null Pseudorandom number generator seed. iterator.seedLength: integer|null Length of generator seed. iterator.state: Uint32Array|null Generator state. iterator.stateLength: integer|null Length of generator state. iterator.byteLength: integer|null Size (in bytes) of generator state. Examples -------- > var it = {{alias}}(); > var r = it.next().value > r = it.next().value See Also --------