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());   //输出:fc3ff98e8c6a0d3087d515c0473f8677

acl::md5::md5_string(strMsg_1, strlen(strMsg_1), NULL, 0, strMd5Result, 33);
printf("md5 result:%s\n", strMd5Result);    //输出:fc3ff98e8c6a0d3087d515c0473f8677

md5.reset();
md5.update(strMsg_1, strlen(strMsg_1));
md5.finish();
printf("md5 result:%s\n", acl::md5::hex_encode(md5.get_digest(), strMd5Result, 33));    //输出:fc3ff98e8c6a0d3087d515c0473f8677

md5.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());  //输出:d4490c78f7248f36e2d79a66bfba10db

acl::md5::md5_string(strMsg_2, strlen(strMsg_2), strMsg_1, strlen(strMsg_1), strMd5Result, 33);
printf("md5 result_2:%s\n", strMd5Result);    //输出:d4490c78f7248f36e2d79a66bfba10db

acl::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 demo
acl::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 demo
acl::md5::md5_file("md5_test_2.txt", NULL, 0, strMd5Result, 33);    //输出:7ce382180581e0b0d160b57a403bcd06

char *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