1.2 Hashlib 模块 API 手册#
1. 概述#
uhashlib 库提供了基于 MD5、SHA1 和 SHA2 算法的二进制数据哈希功能。
2. API 介绍#
uhashlib 库提供了三个类：md5、sha1 和 sha256。这些类分别实现了两个函数：数据更新函数 update() 和消息摘要函数 digest()。其中，md5 和 sha1 是 MicroPython 的软件实现；sha256 则由底层硬件加速器加速。
注意：本文档不详细介绍 md5 和 sha1 的使用步骤，具体请参考 MicroPython hash 官方文档
2.1 类 sha256#
描述
sha256 类用于创建一个 SHA256 哈希对象，并可选择性地向其中发送数据。
语法
uhashlib.sha256([data])
参数
参数名称 |
描述 |
输入/输出 |
|---|---|---|
data (可选) |
二进制数据 |
输入 |
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
示例
data = bytes([0]*64)
hash_obj = uhashlib.sha256(data)
hash_obj.update(data)
dgst = hash_obj.digest()
print(dgst)
2.1.1 数据更新函数 update()#
描述
如果需要多次输入二进制数据，可以调用 update() 函数更新数据。
语法
obj.update(data)
参数
参数名称 |
描述 |
输入/输出 |
|---|---|---|
data |
输入二进制数据 |
输入 |
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.1.2 消息摘要函数 digest()#
描述 返回所有输入数据的哈希值。
注意：在 MicroPython 中，使用此函数会完成最后的计算，而不仅仅是显示结果。因此只能调用一次，如果需要多次使用该值，请保存到变量中。
语法
dgst = hash.digest()
print(dgst)
/*********** 注意 ***********/
a = hash.digest()
b = hash.digest() # 错误
参数
无
返回值
返回值 |
描述 |
|---|---|
0 |
成功 |
非 0 |
失败 |
2.1.3 十六进制消息摘要函数 hexdigest()#
该方法未实现。可以使用 binascii.hexlify(hash.digest()) 达到类似效果。
3. 示例程序#
计算哈希值#
import uhashlib
import binascii
# 初始化 sha256 对象
obj = uhashlib.sha256()
# 输入数据1
obj.update(b'hello')
# 输入数据2
obj.update(b'world')
# 计算摘要
dgst = obj.digest()
print(binascii.hexlify(dgst))
# b'936a185caaa266bb9cbe981e9e05cb78cd732b0b3280eb944412bb6f8f8f07af'