randomInt.md (1594B)
1 <!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. --> 2 3 # Function randomInt 4 5 Return a random integer number larger or equal to `min` and smaller than `max` 6 using a uniform distribution. 7 8 9 ## Syntax 10 11 ```js 12 math.randomInt() // generate a random integer between 0 and 1 13 math.randomInt(max) // generate a random integer between 0 and max 14 math.randomInt(min, max) // generate a random integer between min and max 15 math.randomInt(size) // generate a matrix with random integer between 0 and 1 16 math.randomInt(size, max) // generate a matrix with random integer between 0 and max 17 math.randomInt(size, min, max) // generate a matrix with random integer between min and max 18 ``` 19 20 ### Parameters 21 22 Parameter | Type | Description 23 --------- | ---- | ----------- 24 `size` | Array | Matrix | If provided, an array or matrix with given size and filled with random values is returned 25 `min` | number | Minimum boundary for the random value, included 26 `max` | number | Maximum boundary for the random value, excluded 27 28 ### Returns 29 30 Type | Description 31 ---- | ----------- 32 number | Array | Matrix | A random integer value 33 34 35 ### Throws 36 37 Type | Description 38 ---- | ----------- 39 40 41 ## Examples 42 43 ```js 44 math.randomInt(100) // returns a random integer between 0 and 100 45 math.randomInt(30, 40) // returns a random integer between 30 and 40 46 math.randomInt([2, 3]) // returns a 2x3 matrix with random integers between 0 and 1 47 ``` 48 49 50 ## See also 51 52 [random](random.md), 53 [pickRandom](pickRandom.md)