符合Misra C++的跨平台md5库封装

2024-05-14 09:20

本文主要是介绍符合Misra C++的跨平台md5库封装,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

概要

这篇文章介绍如何使用 C++ 代码实现 MD5 算法的计算。示例代码由以下几个部分组成:

  • md5.h: 定义 MD5 算法相关的常量、数据结构以及函数接口。
  • md5.cpp: 实现 MD5 算法的核心运算逻辑。
  • md5_wrapper.h: 封装通用的 MD5 计算接口。
  • md5_test.cpp: 测试程序,演示如何使用 Md5Wrapper 类进行 MD5 计算和校验。
  • **example.txt和example.txt.md5: **为测试的md5文件,example.txt.md5使用md5sum example.txt > example.txt.md5生成。

详细代码路径:https://gitee.com/liudegui/md5_wrapper

md5.h 和 md5.cpp

这两个文件提供了 MD5 算法的底层实现。其中,md5.h 定义了常用的常量(如 MD5 哈希值长度)、数据结构(用于存储算法中间状态)以及四个函数接口:

  • md5_init:初始化 MD5 计算上下文。
  • md5_update:更新 MD5 计算上下文,处理一部分输入数据。
  • md5_final:完成 MD5 计算,生成最终的哈希值。
  • md5_print:将哈希值转换为字符串格式。

md5.cpp 则实现了这四个函数的具体逻辑,通过复杂的 bit 操作完成 MD5 算法的运算过程。

md5_wrapper.h 和 md5_test.cpp

这两个文件提供了更易于使用的 MD5 计算接口。md5_wrapper.h 定义了一个 Md5Wrapper 类,封装了常用的 MD5 计算操作:

  • calculate_string_md5:计算字符串的 MD5 哈希值。
  • calculate_file_md5:计算文件的 MD5 哈希值。
  • calculate_buf_md5:计算内存数据块的 MD5 哈希值。
  • check_md5_file:校验文件与其对应的 .md5 校验文件的哈希值是否一致。

md5_test.cpp 则是一个测试程序,演示了如何使用 Md5Wrapper 类进行各种 MD5 计算操作。例如,计算字符串的 MD5 值、计算文件哈希值,以及校验文件与 .md5 校验文件的一致性。

md5.cpp 的详细解释

md5.cpp 文件包含了 MD5 算法的核心实现。这里列出了一些重要的函数及其功能:

  • md5_fmd5_i: 这几个函数实现了 MD5 算法的核心运算步,它们根据输入数据以及当前的 MD5 状态值,进行逻辑运算并更新状态值。
  • md5_step: 这是一个封装函数,根据指定的步函数 (StepFunctionType)、当前的 MD5 状态值和输入数据,完成一次 MD5 算法的迭代运算。
  • md5_setmd5_get: 这两个函数根据小端字节序的规则,将输入的字节数组转换为一个适合于算法处理的 32 位整数。
  • body: 这是一个内部函数,它处理一个或多个 64 字节的數據块,并更新 MD5 算法的中间状态。
  • md5_init: 初始化 MD5 计算上下文,将四个哈希值设置为特定的初始值。
  • md5_update: 更新 MD5 计算上下文,处理一部分输入数据。该函数会根据缓冲区中的数据量以及输入数据的多少,分段进行处理。
  • convert_to_bytes: 将一个 32 位整数转换为 4 个字节的字符数组,并按照小端字节序进行排列。
  • md5_final: 完成 MD5 计算,将最后剩下的数据块处理完毕,并根据填充规则进行补位操作。最后,将计算的最终结果转换为哈希值。
  • md5_print: 将哈希值的字节数组转换为十六进制的字符串格式。

示例代码

md5_test.cpp 文件提供了完整的示例代码,演示了如何使用 Md5Wrapper 类进行 MD5 计算和校验。例如,以下代码段计算字符串 “This is a test string” 的 MD5 哈希值:

std::string data = "This is a test string";
std::string md5_str;
if (MD5Test::Md5Wrapper::calculate_string_md5(data, md5_str) != 0) {std::cerr << "Error calculating MD5 of string" << std::endl;return 1;
}std::cout << "MD5 of string: " << md5_str << std::endl;

封装的实现

md5_wrapper.h 文件中定义的 Md5Wrapper 类提供了对 MD5 算法的封装,简化了用户的使用。该类包含了以下成员函数:

  • calculate_string_md5(const std::string& in_str, std::string& md5_str) :计算字符串的 MD5 哈希值。
int32_t calculate_string_md5(const std::string &in_str, std::string &md5_str) {return calculate_buf_md5(in_str.c_str(), in_str.size(), md5_str);
}

该函数首先调用 calculate_buf_md5 函数来计算字符串内容的 MD5 哈希值,然后将结果转换为字符串格式并存储在 md5_str 参数中。

  • calculate_file_md5(const std::string& in_filename, std::string& md5_str, uint64_t total_size) :计算文件的 MD5 哈希值。
int32_t calculate_file_md5(const std::string &in_filename, std::string &md5_str, uint64_t total_size) {int32_t status_ret = 0;if (total_size == 0) {struct stat statbuf_obj;if (stat(in_filename.c_str(), &statbuf_obj) == 0) {total_size = static_cast<uint64_t>(statbuf_obj.st_size);} else {status_ret = -1;}}if (status_ret == 0) {Md5Ctx md5_ctx_obj;md5_init(md5_ctx_obj);(void)update_file_md5(md5_ctx_obj, in_filename, total_size);Md5Result result_obj;Md5ResultStr result_str_obj;md5_final(result_obj.md5_result_16, md5_ctx_obj);md5_print(result_str_obj.result_str, result_obj.md5_result_16, sizeof(result_str_obj.result_str));md5_str = uint8_to_char(result_str_obj.result_str);}return status_ret;
}

该函数首先获取文件的大小,如果 total_size 参数为 0,则会自动获取文件大小。然后,创建一个 Md5Ctx 对象用于存储 MD5 计算的上下文信息,并调用 md5_init 函数对其进行初始化。接下来,调用 update_file_md5 函数逐个读取文件内容并更新 MD5 计算上下文。最后,调用 md5_final 函数完成 MD5 计算,并将结果转换为字符串格式并存储在 md5_str 参数中。

  • calculate_buf_md5(const char *const in_buf, uint64_t total_size, std::string &md5_str) :计算内存数据块的 MD5 哈希值。
int32_t calculate_buf_md5(const char *const in_buf, uint64_t total_size, std::string &md5_str) {int32_t status_ret = 0;if ((in_buf != nullptr) && ((total_size != 0))) {Md5Ctx md5_ctx_obj;md5_init(md5_ctx_obj);md5_update(md5_ctx_obj, in_buf, total_size);Md5Result result_obj;Md5ResultStr result_str_obj;md5_final(result_obj.md5_result_16, md5_ctx_obj);md5_print(result_str_obj.result_str, result_obj.md5_result_16, sizeof(result_str_obj.result_str));md5_str = uint8_to_char(result_str_obj.result_str);

这篇关于符合Misra C++的跨平台md5库封装的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/988377

相关文章

SpringBoot中封装Cors自动配置方式

《SpringBoot中封装Cors自动配置方式》:本文主要介绍SpringBoot中封装Cors自动配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录SpringBoot封装Cors自动配置背景实现步骤1. 创建 GlobalCorsProperties

SpringBoot实现MD5加盐算法的示例代码

《SpringBoot实现MD5加盐算法的示例代码》加盐算法是一种用于增强密码安全性的技术,本文主要介绍了SpringBoot实现MD5加盐算法的示例代码,文中通过示例代码介绍的非常详细,对大家的学习... 目录一、什么是加盐算法二、如何实现加盐算法2.1 加盐算法代码实现2.2 注册页面中进行密码加盐2.

C++ 中的 if-constexpr语法和作用

《C++中的if-constexpr语法和作用》if-constexpr语法是C++17引入的新语法特性,也被称为常量if表达式或静态if(staticif),:本文主要介绍C++中的if-c... 目录1 if-constexpr 语法1.1 基本语法1.2 扩展说明1.2.1 条件表达式1.2.2 fa

C++中::SHCreateDirectoryEx函数使用方法

《C++中::SHCreateDirectoryEx函数使用方法》::SHCreateDirectoryEx用于创建多级目录,类似于mkdir-p命令,本文主要介绍了C++中::SHCreateDir... 目录1. 函数原型与依赖项2. 基本使用示例示例 1:创建单层目录示例 2:创建多级目录3. 关键注

C++从序列容器中删除元素的四种方法

《C++从序列容器中删除元素的四种方法》删除元素的方法在序列容器和关联容器之间是非常不同的,在序列容器中,vector和string是最常用的,但这里也会介绍deque和list以供全面了解,尽管在一... 目录一、简介二、移除给定位置的元素三、移除与某个值相等的元素3.1、序列容器vector、deque

C++常见容器获取头元素的方法大全

《C++常见容器获取头元素的方法大全》在C++编程中,容器是存储和管理数据集合的重要工具,不同的容器提供了不同的接口来访问和操作其中的元素,获取容器的头元素(即第一个元素)是常见的操作之一,本文将详细... 目录一、std::vector二、std::list三、std::deque四、std::forwa

C++字符串提取和分割的多种方法

《C++字符串提取和分割的多种方法》在C++编程中,字符串处理是一个常见的任务,尤其是在需要从字符串中提取特定数据时,本文将详细探讨如何使用C++标准库中的工具来提取和分割字符串,并分析不同方法的适用... 目录1. 字符串提取的基本方法1.1 使用 std::istringstream 和 >> 操作符示

C++原地删除有序数组重复项的N种方法

《C++原地删除有序数组重复项的N种方法》给定一个排序数组,你需要在原地删除重复出现的元素,使得每个元素只出现一次,返回移除后数组的新长度,不要使用额外的数组空间,你必须在原地修改输入数组并在使用O(... 目录一、问题二、问题分析三、算法实现四、问题变体:最多保留两次五、分析和代码实现5.1、问题分析5.

C++ 各种map特点对比分析

《C++各种map特点对比分析》文章比较了C++中不同类型的map(如std::map,std::unordered_map,std::multimap,std::unordered_multima... 目录特点比较C++ 示例代码 ​​​​​​代码解释特点比较1. std::map底层实现:基于红黑

C++中函数模板与类模板的简单使用及区别介绍

《C++中函数模板与类模板的简单使用及区别介绍》这篇文章介绍了C++中的模板机制,包括函数模板和类模板的概念、语法和实际应用,函数模板通过类型参数实现泛型操作,而类模板允许创建可处理多种数据类型的类,... 目录一、函数模板定义语法真实示例二、类模板三、关键区别四、注意事项 ‌在C++中,模板是实现泛型编程