Random\Randomizer::nextInt

(PHP 8 >= 8.2.0)

Random\Randomizer::nextInt — 取得正整數

public Random\Randomizer::nextInt(): int

警告

此函式目前尚未文件化；僅提供其參數列表。

此函式沒有參數。

介於 0 和最大值之間的正整數，最大值取決於 Random\Engine::generate() 回傳的位元組數。確切的最大值可計算為 2^{$engine_bytes * 8 - 1} - 1。

為了避免不一致，如果 Random\Engine::generate() 的輸出大小超過 32 位元，32 位元的 PHP 將會拋出 Random\RandomException，因為選取的整數無法無損地回傳。這會影響原生 64 位元的引擎 Random\Engine\PcgOneseq128XslRr64 和 Random\Engine\Xoshiro256StarStar。任何回傳超過 4 個位元組隨機性的使用者層級引擎也會受影響。
由底層 Random\Randomizer::$engine 的 Random\Engine::generate() 方法拋出的任何 Throwable。

範例 #1 Random\Randomizer::nextInt() 範例

<?php
$r = new \Random\Randomizer();

// 隨機「下一個」整數：
echo $r->nextInt(), "\n";
?>

上述範例會輸出類似以下的結果

8041689838856078718

此頁面沒有使用者貢獻的註解。