函数

GLibChecksumnew

自: 2.16

声明 [src]

GChecksum*
g_checksum_new (
  GChecksumType checksum_type
)

描述 [src]

创建一个新的 GChecksum，使用校验和算法 checksum_type。如果 checksum_type 未知，则返回 NULL。一个 GChecksum 可以用来计算任意二进制块（blob）的校验和（或摘要），使用不同的哈希算法。

GChecksum 通过将二进制块通过 g_checksum_update() 进行馈送，直到有数据可以进行检查；然后可以使用 g_checksum_get_string() 提取摘要，这将返回一个十六进制字符串作为校验和；或者使用 g_checksum_get_digest()，这将返回一个原始字节的向量。一旦对一个 GChecksum 调用了 g_checksum_get_string() 或 g_checksum_get_digest()，校验和将被关闭，将无法再调用 g_checksum_update()。

自版本 2.16 起可用

参数

checksum_type

类型: GChecksumType

期望的校验和类型。

返回值

类型: GChecksum

新创建的 GChecksum 或 NULL。使用 g_checksum_free() 释放由其分配的内存。

该函数的调用者拥有数据，并负责释放它。

返回值可以是 NULL。