random --- 產生亂數

此模組實作了一個偽隨機數產生器（PRNG）。此 PRNG 是一個 32 位元的 Yasmarang 風格 LCG；在首次匯入時，它會從 os.urandom() 所使用的同一硬體來源取得一個 32 位元的種子，而之後產生的每一個數，都是該種子的確定性函式。

警告

其輸出並非具密碼學安全性——該演算法可由一段簡短的輸出序列預測，而初始種子僅帶有 32 位元的熵。對於金鑰材料、工作階段權杖（session token）、密碼鹽（salt），或任何其他與安全相關的用途，請改為呼叫 os.urandom()。

備註

區間使用下列表示法：

• () 為開區間括號，不包含其端點。例如，(0, 1) 表示大於 0 且小於 1。以集合表示法：(0, 1) = {x | 0 < x < 1}。

• [] 為閉區間括號，包含其所有界限點。例如，[0, 1] 表示大於或等於 0 且小於或等於 1。以集合表示法：[0, 1] = {x | 0 <= x <= 1}。

整數相關函式

random.getrandbits(n: int) → int

傳回一個帶有 n 個隨機位元的整數（0 <= n <= 32）。

random.randint(a: int, b: int) → int

傳回範圍 [a, b] 內的一個隨機整數。

random.randrange(start: int, stop: int | None = None, step: int = 1) → int

第一種形式從範圍 [0, stop) 傳回一個隨機整數。第二種形式從範圍 [start, stop) 傳回一個隨機整數。第三種形式以 step 為間隔，從範圍 [start, stop) 傳回一個隨機整數。例如，呼叫 randrange(1, 10, 2) 將傳回 1 到 9（含）之間的奇數。

浮點數相關函式

random.random() → float

傳回範圍 [0.0, 1.0) 內的一個隨機浮點數。

random.uniform(a: float, b: float) → float

傳回一個隨機浮點數 N，使得在 a <= b 時 a <= N <= b，而在 b < a 時 b <= N <= a。

其他函式

random.seed(n: int | None = None, /) → None

以種子 n 初始化亂數產生器模組，n 應為整數。當未傳入任何引數（或傳入 None）時，PRNG 會從 os.urandom() 所使用的同一個埠專屬來源重新設定種子。

random.choice(sequence: Any) → Any

從 sequence（元組、串列，或任何支援下標運算的物件）中隨機選取並傳回一個項目。