V1.0.6

packages/third-party/micropython-1.13.0/docs/std-librarys/urandom.md

@@ -0,0 +1,174 @@
+## **urandom** - 随机数生成模块
+
+`urandom` 模块实现了伪随机数生成器。
+
+### 函数 
+
+#### **urandom.choice**(obj)  
+
+随机生成对象 obj 中的元数。
+
+```
+obj：元数列表
+```
+
+示例：
+
+```python
+>>> print(random.choice("DFRobot"))
+R
+>>> print(random.choice("DFRobot"))
+D
+>>> print(random.choice([0, 2, 4, 3]))
+3
+>>> print(random.choice([0, 2, 4, 3]))
+3
+>>> print(random.choice([0, 2, 4, 3]))
+2
+```
+
+#### **urandom.getrandbits**(size)  
+
+随机生成 0 到 size 个位二进制数范围内的正整数。 比如 ：
+
+- size = 4，那么便是从 0 到0b1111中随机一个正整数。 
+- size = 8，那么便是从 0 到 0b11111111中随机一个正整数。
+
+```python
+size：位大小
+```
+
+示例：
+
+```python
+>>> print( random.getrandbits(1))  #1位二进制位，范围为0~1（十进制：0~1）
+1
+>>> print(random.getrandbits(1))
+0
+>>> print(random.getrandbits(8))  #8位二进制位，范围为0000 0000~1111 11111（十进制：0~255）
+224
+>>> print(random.getrandbits(8))
+155
+```
+
+#### **urandom.randint**(start, end)  
+
+随机生成一个 start 到 end 之间的整数。 
+
+```
+start：指定范围内的开始值，包含在范围内
+end：指定范围内的结束值，包含在范围内
+```
+
+示例：
+
+```python
+>>> import random
+>>> print(random.randint(1, 4))
+4
+>>> print(random.randint(1, 4))
+2
+```
+
+#### **urandom.random**()  
+随机生成一个 0 到 1 之间的浮点数。 
+示例：
+
+```python
+>>> print(random.random())
+0.7111824
+>>> print(random.random())
+0.3168149
+```
+
+#### **urandom.randrange**(start, end, step)  
+
+随机生成 start 到 end 并且递增为 step 的范围内的正整数。例如，randrange(0, 8, 2)中，随机生成的数为 0、2、4、6 中任一个。
+
+```
+start：指定范围内的开始值，包含在范围内
+end：指定范围内的结束值，包含在范围内
+step：递增基数
+```
+
+示例：
+
+```python
+>>> print(random.randrange(2, 8, 2))
+4
+>>> print(random.randrange(2, 8, 2))
+6
+>>> print(random.randrange(2, 8, 2))
+2
+```
+
+#### **urandom.seed**(sed)  
+
+指定随机数种子，通常和其他随机数生成函数搭配使用。 
+**注意：** 
+   MicroPython 中的随机数其实是一个稳定算法得出的稳定结果序列，而不是一个随机序列。sed 就是这个算法开始计算的第一个值。所以就会出现只要 sed 是一样的，那么后续所有“随机”结果和顺序也都完全一致。
+
+```
+sed：随机数种子
+```
+
+示例：
+
+```python
+import random
+
+for j in range(0, 2):
+  random.seed(13)  #指定随机数种子
+  for i in range(0, 10):  #生成0到10范围内的随机序列
+    print(random.randint(1, 10))
+  print("end")
+```
+
+运行结果：
+
+```
+5
+2
+3
+2
+3
+4
+2
+5
+8
+2
+end
+5
+2
+3
+2
+3
+4
+2
+5
+8
+2
+end
+```
+
+   从上面可以看到生成两个随机数列表是一样的，你也可以多生成几个随机数列表查看结果。
+
+#### **urandom.uniform**(start, end)  
+
+随机生成start到end之间的浮点数。
+
+```
+start：指定范围内的开始值，包含在范围内
+stop：指定范围内的结束值，包含在范围内
+```
+
+示例：
+
+```python
+>>> print(random.uniform(2, 4))
+2.021441
+>>> print(random.uniform(2, 4))
+3.998012
+```
+
+更多内容可参考 [urandom](https://docs.python.org/3/library/random.html?highlight=random#module-random) 。