MATLAB通用INI配置文件解析与生成工具

资 源 简 介

该项目提供了一套在MATLAB开发环境中高效读写.ini配置文件的完整解决方案。由于MATLAB官方内置函数库目前缺乏专门处理.ini格式的直接支持，本工具通过解析底层的文本流，实现了对该格式文件的结构化读写，极大地增强了MATLAB与外部应用之间的配置兼容性。

详 情 说 明

MATLAB内置.ini配置文件解析与生成工具

项目介绍

本项目专门为MATLAB开发环境设计，提供了一套轻量级且高效的.ini格式配置文件读写解决方案。由于MATLAB原生库并未提供直接处理.ini文件的标准函数，本工具通过底层文本流解析与正则表达式匹配，实现了MATLAB嵌套结构体与标准INI文本之间的双向转换。该工具不仅能够保持配置文件的层级结构，还具备自动类型识别功能，极大地方便了MATLAB程序与外部应用程序、系统环境之间的配置交互。

功能特性

1. 双向转换：支持将MATLAB嵌套结构体（Struct）直接导出为标准的.ini文件，同时可将.ini文件解析还原为MATLAB语义化的结构体。
2. 智能类型推断：在读取过程中，工具能自动识别数值（包括标量和数组）与字符串。对于符合数值格式的内容，会自动转换为双精度浮点数；否则保留为字符串格式。
3. 结构化映射：严格遵循INI标准，将结构体的一级字段映射为节（Section），二级字段映射为键（Key）。
4. 字符兼容性处理：内置正则清洗机制，自动将不符合MATLAB变量命名规则的非法字符（如空格、特殊符号）转换为下划线，防止程序报错。
5. 注释与空行支持：读取时能自动忽略以分号（;）或井号（#）开头的注释行，以及文件中的空白行。
6. 多编码支持：支持指定文本编码（默认使用UTF-8），确保跨平台使用时字符不乱码。

系统要求

• 软件环境：MATLAB R2016b 或更高版本（因使用了startsWith、isstring等函数及正则表达式）。
• 操作系统：兼容Windows、Linux及macOS。

使用方法

通过主函数演示的流程，用户可以快速上手：

1. 数据准备：创建一个二级嵌套结构体，其中包含各种需要配置的项目（如系统设置、数据库连接、UI参数等）。
2. 调用写入功能：使用写入接口并传入文件名与结构体，工具将自动生成格式化的.ini文本。
3. 调用读取功能：传入.ini文件路径，工具将返回一个与原结构体逻辑一致的MATLAB结构体供后续代码调用。
4. 结果验证：通过遍历解析后的结构体字段，可以实时查看每个配置项的数据类型及其对应的值。

核心实现逻辑分析

写入算法逻辑

在执行写入操作时，工具遵循以下流程：

• 结构体递归遍历：提取结构体的顶层字段名作为INI的[Section]。对于每个Section下的子字段，将其作为Key。
• 多类型数据转换：

* 数值/逻辑型：对于单个数值，使用简单的字符串转换；对于包含多个元素的数组，使用格式化打印将其转换为以空格分隔的字符串。 * 字符/字符串型：直接写入文本流。

• 格式优化：在每个Section处理结束后会自动插入回车换行符，确保生成的配置文件具备良好的可读性。

读取与解析算法逻辑

读取过程基于状态机思维，分行进行处理：

• 行过滤：通过剪裁行首尾空格，并检测首字符是否为注释符号（; 或 #）来过滤无效信息。
• 正则表达式匹配：

* 使用正则表达式 ^[([^]]+)] 捕获方括号内的内容作为当前的节（Section）名称，并同步初始化MATLAB结构体字段。 * 使用正则表达式 ^([^=]+)=(.*)$ 捕获等号两边的内容，分别对应键（Key）和值（Value）。

• 变量名安全处理：无论是Section还是Key，在存入MATLAB结构体前都会经过 W 匹配清洗，确保所有的非单词字符被下划线替换，满足MATLAB字段命名规范。
• 动态类型识别：解析出的Value字符串会先尝试通过 str2num 进行转换。如果转换结果为非空数值（针对标量或矩阵），则以数值形式存储；若转换失败，则作为原始字符串存储，从而实现了对配置数据的“智能化”解析。