1. INI文件简介INI文件时Initialization File的缩写即初始化文件。INI文件是Windows系统常见的配置文件存储格式当前也可作为Linux的配置文件。INI文件由节、键、值组成。“节”的表达方式为[Section1 Name]以中括号“[]”包围起来它用来表示一个段落的开始因INI文件可能是整个项目共用的所以需要使用“节”来区分不同用途的参数区。“键”与“值”的组合表达方式为KeyNamevalue以等号“”分隔。INI文件注释以分号“;”表示在分号后面的文字直到该行结尾全部作为注解。例程如下所示注意value值只有int型和string型。; comment textINI文件的数据格式的例子配置文件的内容 [Section1 Name] KeyName1value1 KeyName2value2 ... [Section2 Name] KeyName21value21 KeyName22value222. 快速上手2.1 开发环境准备如果您初次阅读此文档请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》并按照其相关的操作进行编译环境的部署。在PC端Ubuntu系统中执行run脚本进入EASY-EAI编译环境具体如下所示。cd ~/develop_environment ./run.sh 22042.2 源码下载以及例程编译在EASY-EAI编译环境下创建存放源码仓库的管理目录cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit通过git工具在管理目录内克隆远程仓库git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git注* 此处可能会因网络原因造成卡顿请耐心等待。* 如果实在要在gitHub网页上下载也要把整个仓库下载下来不能单独下载本实例对应的目录。进入到对应的例程目录执行编译操作具体命令如下所示cd EASY-EAI-Toolkit-1126B/Demos/common-ini/ ./build.sh注* 由于依赖库部署在板卡上因此交叉编译过程中必须保持/mnt挂载。2.3 例程运行通过串口调试或ssh调试进入板卡后台定位到例程部署的位置如下所示cd /userdata/Demo/common-ini运行例程命令如下所示./test-iniWrapper2.4 运行效果执行效果如下所示。API的详细说明以及API的调用本例程源码详细信息见下方说明。3. INI文件API说明3.1 引用方式EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库此处列出工程中需要链接的库以及头文件等方便用户直接添加。API源代码路径为EASY-EAI-Toolkit-1126B/easyeai-api/common/ini/。用户可通过源代码了解接口实现甚至可对源码进行修改。3.2 INI读取整型数据函数原型如下所示。int32_t ini_read_int(const char *file, const char *pcSection, const char *pcKey, int *pVal);具体介绍如下所示。3.3 INI写入整型数据函数原型如下所示。int32_t ini_write_int(const char *file, const char *pcSection, const char *pcKey, int Val);具体介绍如下所示。3.4 INI读取字符串数据函数原型如下所示。int32_t ini_read_string(const char *file, const char *pcSection, const char *pcKey, char *pcStr, int len);具体介绍如下所示。3.5 INI写入字符串数据函数原型如下所示。int32_t ini_write_string(const char *file, const char *pcSection, const char *pcKey, const char *pcStr);具体介绍如下所示。4. INI文件操作函数使用案例使用代码为EASY-EAI-Toolkit-1126B/Demos/common-ini/test-iniWrapper.c程序逻辑如下所示。
