acl库的使用之md5

_头文件位于：lib_acl_cpp\include\acl_cpp\stdlib\md5.hpp
1、md5& update(const void* dat, size_t len);
/**
* 可以循环调用此函数添加需要被 md5 的数据
* @param dat {const void*} 数据地址
* @param len {size_t} dat 数据长度
* @return {md5&}
*/

2、md5& finish();
/**
* 必须调用本函数表示 md5 过程结束
* @return {md5&}
*/

3、md5& reset();
/**
* 重置 md5 算法器的状态，从而允许重复使用同一个 md5 对象
* @return {md5&}
*/

4、const char* get_digest() const;
/**
* 获得二进制格式的 md5 结果值
* @return {const char*} 返回值永远非空，且缓冲区长度为 16 字节
*/

5、const char* get_string() const;
/**
* 获得以字符串形式表示的 m5 结果值
* @return {const char*} 返回值永远非空，且以 \0 结尾，且字符串
* 长度为 32 字节
*/

6、static const char* md5_digest(const void dat, size_t dlen,const void *key, size_t klen, void out, size_t size);
/**
* 将数据用 md5 算法计算签名值，取得 128 位 (即 16 字节) 二进制结果
* @param dat {const void*} 源数据
* @param dlen {size_t} dat 数据长度
* @param key {const char*} 非空时做为键数据
* @param klen {size_t} key 非空时表示 key 的长度
* @param out {void*} 存储 md5 结果
* @param size {size_t} out 大小，至少应该为 16 字节
* @return {const char*} 返回存储结果的地址(即 out 地址)
*/

7、static const char* md5_string(const void dat, size_t dlen,const void *key, size_t klen, char out, size_t size);
/**
* 将数据用 md5 算法计算签名值，取得字符串形式的结果
* @param dat {const void*} 源数据
* @param dlen {size_t} dat 数据长度
* @param key {const char*} 非空时做为键数据
* @param klen {size_t} key 非空时表示 key 的长度
* @param out {void*} 存储 md5 结果
* @param size {size_t} out 大小，至少应该为 33 字节
* @return {const char*} 返回存储结果的地址(即 out 地址)，
* 且返回值为以 \0 结尾的 32 字节长度(不含 \0)字符串
*/

8、static long long int md5_file(const char* path, const void key,size_t klen, char out, size_t size);
/**
* 将文件中的内容用 md5 算法计算签名值，并取得字符串形式结果
* @param path {const char*} 文件全路径
* @param key {const char*} 非空时做为键数据
* @param klen {size_t} key 非空时表示 key 的长度
* @param out {void*} 存储 md5 结果
* @param size {size_t} out 大小，至少应该为 33 字节
* @return {int64) 返回所读取的文件数据的长度，下列情况下返回 -1
* 1) 打开文件失败
* 2) 未从文件中读到数据
* 3) out 缓冲区大小 size 小于 33 字节长度
*/
9、static long long int md5_file(istream& in, const void key,size_t klen, char out, size_t size);
/**
* 将文件中的内容用 md5 算法计算签名值，并取得字符串形式结果
* @param in {istream&} 输入文件流
* @param key {const char*} 非空时做为键数据
* @param klen {size_t} key 非空时表示 key 的长度
* @param out {void*} 存储 md5 结果
* @param size {size_t} out 大小，至少应该为 33 字节
* @return {int64) 返回所读取的文件数据的长度，下列情况下返回 -1:
* 1) 未从输入流中读取数据时
* 2) out 缓冲区大小 size 小于 33 字节长度
*/

10、static const char* hex_encode(const void in, char out, size_t size);
/**
* 将 16 字节长度的 MD5 二进制结果转换为 32 字节长度的字符串
* @param in {const void*} 128 位(即 16 字节)的 md5 值，即 in 的数据长度
* 至少应该 >= 16，否则会引起内存起越界
* @param out {char*} 存储字符串形式的结果
* @param size {size_t} out 内存大小，至少为 33 字节，否则内部产生断言
* @return {const char*} 返回存储结果的地址(即 out 地址)，
* 且返回值为以 \0 结尾的 32 字节长度(不含 \0)字符串
*/

使用示例：

acl::md5 md5;char *strMsg_1 = "hello world!";char *strMsg_2 = "acl::md5 demo";char strMd5Digest[17] = {0};char strMd5Result[33] = {0};md5.update(strMsg_1, strlen(strMsg_1));md5.finish();printf("md5 result:%s\n", md5.get_string());   //输出:fc3ff98e8c6a0d3087d515c0473f8677acl::md5::md5_string(strMsg_1, strlen(strMsg_1), NULL, 0, strMd5Result, 33);printf("md5 result:%s\n", strMd5Result);    //输出:fc3ff98e8c6a0d3087d515c0473f8677md5.reset();md5.update(strMsg_1, strlen(strMsg_1));md5.finish();printf("md5 result:%s\n", acl::md5::hex_encode(md5.get_digest(), strMd5Result, 33));    //输出:fc3ff98e8c6a0d3087d515c0473f8677md5.reset();md5.update(strMsg_1, strlen(strMsg_1));md5.update(strMsg_2, strlen(strMsg_2));md5.finish();printf("md5 result_1:%s\n", md5.get_string());  //输出:d4490c78f7248f36e2d79a66bfba10dbacl::md5::md5_string(strMsg_2, strlen(strMsg_2), strMsg_1, strlen(strMsg_1), strMd5Result, 33);printf("md5 result_2:%s\n", strMd5Result);    //输出:d4490c78f7248f36e2d79a66bfba10dbacl::md5::md5_digest(strMsg_1, strlen(strMsg_1), NULL, 0, strMd5Digest, 17);acl::md5::hex_encode(strMd5Digest, strMd5Result, 33);printf("md5 result:%s\n", strMd5Result);    //输出：fc3ff98e8c6a0d3087d515c0473f8677若文件md5_test.txt中只包含一行记录,内容为：hello world!acl::md5 demoacl::md5::md5_file("md5_test.txt", NULL, 0, strMd5Result, 33);printf("md5 result:%s\n", strMd5Result);    //输出:d4490c78f7248f36e2d79a66bfba10db若文件md5_test_2.txt中只包含两行记录,第一行为：hello world!,第二行为：acl::md5 demoacl::md5::md5_file("md5_test_2.txt", NULL, 0, strMd5Result, 33);    //输出:7ce382180581e0b0d160b57a403bcd06char *strMsg_3 = "hello world!\r\n";acl::md5::md5_string(strMsg_2, strlen(strMsg_2), strMsg_3, strlen(strMsg_3), strMd5Result, 33);printf("md5 result_2:%s\n", strMd5Result);  //输出:7ce382180581e0b0d160b57a403bcd06