# `uhashlib` – 散列算法

  - [概要](#概要)
  - [`uhashlib` API详解](#uhashlib-api详解)
    - [构造函数](#构造函数)
    - [创建hasher对象](#创建hasher对象)
    - [方法](#方法)

## 概要

  该模块实现相应 `CPython`模块的子集

  该模块实现二进制数据的散列算法。目前实现了SHA256算法。SHA256是深思熟虑之选，这是一种现代的加密安全算法。 这意味着单个算法既可覆盖任何散列算法的用例，也可覆盖与安全相关的使用，从而省略了诸如MD5或SHA1之类的遗留算法以节省时间。

- SHA256 - 最新一代，现代散列算法（SHA2串联）。适用于包含在MicroPython核心中的加密安全，且除有特定代码大小限制外，建议所有板都提供该算法。
- SHA1 - 上一代算法。不推荐作新用法，但是SHA1属于网络标准与现有应用程序的一部分，因此针对网络连通性和可互通性的板子将尝试实现这一算法。
- MD5 - 遗留算法，并未实现加密安全等相关功能。只有选定的针对遗留应用程序的可使用性的板才提供这一算法。

## `uhashlib` API详解

  使用`import uhashlib`导入`uhashlib`模块

  再使用`TAB` 按键来查看`uhashlib`中所包含的内容：

```python
>>> import uhashlib
>>> uhashlib.
__name__        sha256
```

### 构造函数

- `class uhashlib.sha256`([*data*])
  

  创建一个hasher对象，并选择性地将数据输入其中。

### 创建hasher对象

  示例：

```python
>>> data=uhashlib.sha256('blackwalnut')
>>> data
<sha256>
```

### 方法

- `hash.update`(*data*)

  将更多二进制数据输入hash。
  
  示例：
  
  ```python
  >>> data=uhashlib.sha256('blackwalnut')
  >>> a.update('LAB')
  ```

- `hash.digest()`

  返回用于所有通过散列传递的所有数据的散列。调用该方法后，其他数据无法再输入到散列中。
  
  示例：
  
  ```python
  >>> data=uhashlib.sha256('blackwalnut')
  >>> a.digest()
  b'K\x1f\xf3S\x12E\xc9|\x81\xc2U\xb1O\x9ao\x86\xdd\xe6>t~\xbbfr#Z\xc9\x9es\x98\xd7\x9e'
  ```