Documentación offline PHP master

Random\Randomizer::nextInt

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Random\Randomizer::nextInt

Obtener un entero positivo

Descripción#

public Random\Randomizer::nextInt(): int
```php

## Parámetros

Esta función no contiene ningún parámetro.

## Valores devueltos

Un entero positivo entre 0 y un valor máximo que depende del número de bytes devueltos por Random\Engine::generate. El valor máximo exacto puede calcularse como 2<sup>\$engine_bytes \* 8 - 1</sup> - 1.

## Errores/Excepciones

- Para evitar inconsistencias, PHP de 32 bits lanzará `Random\RandomException` si el tamaño de salida de Random\Engine::generate excede 32 bits, ya que el entero seleccionado no puede devolverse sin pérdida. Esto afecta a los motores nativos de 64 bits `Random\Engine\PcgOneseq128XslRr64` y `Random\Engine\Xoshiro256StarStar`. Cualquier motor de usuario que devuelva más de 4 bytes de aleatoriedad también se ve afectado.

- Cualquier `Throwable` lanzado por el método Random\Engine::generate del [`Random\Randomizer::$engine`](#random-randomizer.props.engine) subyacente.

## Ejemplos

`Random\Randomizer::nextInt` ejemplo
nextInt(), "\n"; ?>

```php

Resultado del ejemplo anterior es similar a:

8041689838856078718