randi

Uniformly distributed random integers.

Syntax

r = randi(imax)                 % scalar in [1, imax]
r = randi(imax, n)              % n×n
r = randi(imax, m, n)           % m×n
r = randi([imin imax], …)       % range [imin, imax]

Description

Returns pseudorandom integers drawn uniformly from [1, imax], or from [imin, imax] when the first argument is a two-element vector. Both endpoints are inclusive. Result type is always int32.

Examples

randi(10)                % integer in [1,10]
randi(6, 1, 100)         % 100 dice rolls
randi([0 9], 3)          % 3×3 of digits 0-9

See also

• rand — Uniformly distributed random numbers in [0, 1].
• randn — Standard-normal random numbers (mean 0, variance 1).