# tensorplay.functional.randint

Source: https://www.tensorplay.cn/docs/generated/tensorplay.functional.randint.html

```python
tensorplay.functional.randint(low=0, high, size, \*, generator=None, out=None, dtype=None, layout=tensorplay.strided, device=None, requires_grad=False) → Tensor
```

Returns a tensor filled with random integers generated uniformly
between low (inclusive) and high (exclusive).

The shape of the tensor is defined by the variable argument size.

> **Note**
>
> With the global dtype default (tensorplay.float32), this function returns a tensor with dtype tensorplay.int64.

Parameters:

- low ([int](https://docs.python.org/3/builtins/functions.html#int), optional) – Lowest integer to be drawn from the distribution. Default: 0.

- high ([int](https://docs.python.org/3/builtins/functions.html#int)) – One above the highest integer to be drawn from the distribution.

- size ([tuple](https://docs.python.org/3/builtins/stdtypes.html#tuple)) – a tuple defining the shape of the output tensor.

Keyword Arguments:

- generator ([tensorplay.Generator](/docs/generated/tensorplay.Generator.html#tensorplay.Generator), optional) – a pseudorandom number generator for sampling

- out ([Tensor](/docs/generated/tensorplay.Tensor.html#tensorplay.Tensor), optional) – the output tensor.

- dtype ([tensorplay.dtype](/docs/generated/tensorplay.DType.html#tensorplay.DType), optional) – the desired data type of returned tensor. Default: if None, this function returns a tensor with dtype tensorplay.int64.

- layout (tensorplay.layout, optional) – the desired layout of returned Tensor. Default: tensorplay.strided.

- device ([tensorplay.device](/docs/generated/tensorplay.Device.html#tensorplay.Device), optional) – the desired device of returned tensor. Default: if None, uses the current device for the default tensor type (see [tensorplay.set_default_device()](/docs/generated/tensorplay.set_default_device.html#tensorplay.set_default_device)). device will be the CPU for CPU tensor types and the current CUDA device for CUDA tensor types.

- requires_grad ([bool](https://docs.python.org/3/builtins/functions.html#bool), optional) – If autograd should record operations on the returned tensor. Default: False.

Example:

```
>>> tensorplay.randint(3, 5, (3,))
tensor([4, 3, 4])

>>> tensorplay.randint(10, (2, 2))
tensor([[0, 2],
        [5, 5]])

>>> tensorplay.randint(3, 10, (2, 2))
tensor([[4, 5],
        [6, 7]])
```