第一章 ini文件读写模块设计.docVIP

ini文件读写模块设计 引言 模块概述 模块通过Linux的基本I/O函数实现，实现读写ini文件功能。Ini文件格式参考附录二ini文件格式。 由于ini文件的特殊格式，模块内部每次在读写ini文件键值时需从文件头查找对应节和对应键，再进行读写操作，在写改写ini文件时需首先建立临时文件，将原ini文件中改写数据之前的数据添加到临时文件，再将需要改写的数据追加到临时文件，然后把原ini文件改写数据之后的数据添加到临时文件尾最后删除原ini文件，将临时文件名改为正式ini文件名完成一次ini文件改写操作。每次调用调用操作临时文件时，需要重新打开临时文件（模块内部不保存打开的临时文件指针）。 应用程序调用该模块进行读写操作流程如下： 词汇表 词汇名称 词汇含义 备注 节(section) Ini文件中中括号的数据 键(KEY) 节中等号左边的数据 值(value) 节中等号右边的数据 约定 文件名：inifiles.c，inifiles.h 模块中其他模块的接口函数前缀：ini_，须在模块头文件中声明，其他为文件内部使用函数在声明时加static前缀。 与其他模块关系 无 函数列表 接口函数 INT32 Ini_Create(INT8 sFileName[]); //创建ini文件 //读取字符键值 INT32 Ini_ReadString(INT8 sSectionName[], INT8 sKeyName[], INT8 sValue[], INT32 lReadLen, INT8 sDefaultVal[]) //读取整形键值 INT32 Ini_ReadInt(INT8 sSectionName[], INT8 sKeyName[], INT32 lDefaultVal); //写键值（字符类型） INT32 Ini_WriteString(INT8 sSectionName[], INT8 sKeyName[], INT8 sValue[]) //写键值（整型） INT32 Ini_WriteIni(INT8 sSectionName[], INT8 sKeyName[], INT32 lValue) //删除键 INT32 Ini_DeleteField(INT8 sSectionName[], INT8 sKeyName[]) //删除节 INT32 Ini_DeleteSection(INT8 sSectionName[]) //关闭ini文件 void Ini_Close() 局部函数 //取得键行数据 INT32 GetKeyLine (INT8 sSection[], INT8 sKey[], INT8 sData[],); //取得键行号 INT32 GetKeyLineNo(INT8 sSection[], INT8 sKey[]); //取得键值 INT32 GetKeyValue(INT8 sLineBuffer[], INT8 sData[]); //追加临时文件 INT32 AppendTmpFile(INT8 sBuffer[]); //读取并追加临时文件 INT32 ReadAndAppendTmpFile(FILE *fd, INT32 lStartLine, INT32 lEndLine); 模块内部函数调用关系 读取字符串Ini_ReadString 读取整形值Ini_ReadInt 调用关系同Ini_ReadString，取得数据后将数据转换为整形。 写字段数据Ini_WriteString 删除节中对应字段Ini_DeleteField 暂不实现。 删除节Ini_DeleteSection 暂不实现 数据结构说明 结构定义 无 宏定义 #define LINEBUFFERLEN 255; //读取行缓冲区 #define TEMPFILENAME “tmp.ini” //临时文件名 局部变量 FILE *fd; //文件指针 接口函数 创建文件 函数名 INT32 Ini_Create(INT8 sFileName[]); 输入参数 文件名 返回值 0-成功，-1-失败 功能 打开ini文件，如不存在则创建 读取字符值 　 INT32 Ini_ReadString(INT8 sSectionName[], INT8 sKeyName[], INT8 sValue[], INT32 lReadLen, INT8 sDefaultVal[]) 输入参数 节名，字段名，字段值 返回值 0-成功，-1-失败 功能 按照节名，字段名读取该字段字符串值 调用流程如下： 读取整形数据 函数名 INT32 Ini_ReadI