基于内存映射文件方式读写ini文件

开发语言：C/C++

支持平台：Windows、Windows CE

实现功能：

实现了一个类CRWINIFILE，提供如下接口函数：

LoadFile
CloseFile
GetProfileString
GetProfileInt
GetProfileSection
GetProfileSectionNames
WriteProfileString
WriteProfileSection
WriteProfileStruct
GetProfileStruct

下载地址：

RWINIFILE源代码

更新历史：

V1.2.1 2010年12月18日

• 将包含文件<tchar.h>从实现文件移到头文件，如出现因<strsafe.h>造成的编译错误，请将"RWINIFILE.h"作为第一个包含头文件。

V1.2 2010年05月11日

• 给一些函数添加了缺省参数值。

V1.1 2010年02月10日

• 代码优化。支持Windows、Windows CE

V1.0 2009年04月28日

• 完成正式版本。支持Windows、Windows CE

附加说明：

通过阅读该代码，可以让初学者快速掌握如何操作内存映射文件。

源代码

RWINIFILE.h

/* ---------------------------------------------------------- 文件名称：RWINIFILE.h 作者：秦建辉 MSN：splashcn@msn.com 当前版本：V1.2.1 历史版本： V1.2.1 2010年12月18日 将包含文件<tchar.h>从实现文件移到头文件，如出现因<strsafe.h>造成的编译错误，请将"RWINIFILE.h"作为第一个包含头文件。 V1.2 2010年05月11日 给一些函数添加了缺省参数值。 V1.1 2010年02月10日 代码优化。支持Windows、Windows CE V1.0 2009年04月28日 完成正式版本。支持Windows、Windows CE 功能描述： 基于内存映射方式读写ini文件 类接口函数： LoadFile CloseFile GetProfileString GetProfileInt GetProfileSection GetProfileSectionNames WriteProfileString WriteProfileSection WriteProfileStruct GetProfileStruct ini文件语法规范: 如果开启UNICODE编译选项，则要求配置文件编码为utf-16，否则要求配置文件编码为utf-8。配置文件可以有BOM标记。 行首字符如果是;或者#，表示该行是注释 行首字符为[，表示该行是分区名。分区名必须严格为[Appname]。 ------------------------------------------------------------ */ #pragma once #include <windows.h> #include <tchar.h> class CRWINIFILE { public: /* 功能：类结构函数 */ CRWINIFILE(void); /* 功能：类析构函数 */ ~CRWINIFILE(void); /* 功能：载入配置文件 参数： lpFileName： 要读取的配置文件名 dwDesiredAccess: GENERIC_READ：以共享方式打开文件，文件必须存在。 GENERIC_WRITE：以独占方式打开文件。总是创建新文件。 GENERIC_READ | GENERIC_WRITE：以独占方式打开文件。如果文件不存在，则自动创建新文件。 dwDesiredSize: 希望的内存映射文件大小。只有文件打开属性包含GENERIC_WRITE，该值必须合理选择。 isWinStyle： 是否是Windows文件风格，默认为TRUE。Windows风格，换行符为/r/n；Linux风格，换行符为/n。 返回值： TRUE：成功 FALSE：失败 */ BOOL LoadFile( LPCTSTR lpFileName, DWORD dwDesiredAccess, DWORD dwDesiredSize, BOOL isWinStyle = TRUE ); /* 功能：关闭配置文件 */ void CloseFile( void ); /* 功能：从配置文件中读取键名对应的键值字符串 参数： lpAppName：分区名，如果为NULL，则获取所有的分区名 lpKeyName：键名，如果为NULL，则获取该分区所有的键名及键值 lpDefault：缺省键值字符串 lpReturnedString：结果存放区 nSize：存放区大小（字符数） 返回值： -1：要检索的内存映射文件不存在 -2：参数错误 -3：接收缓冲区长度不满足基本要求 >=0：拷贝的字符个数 */ INT GetProfileString( LPCTSTR lpAppName, LPCTSTR lpKeyName, LPCTSTR lpDefault, LPTSTR lpReturnedString, DWORD nSize ); /* 功能：从配置文件中读取键名对应的整数 参数： lpAppName：分区名 lpKeyName：键名 lpDefault：缺省键值 返回值： 键名所对应的键值。 说明： 键值第一个字符（不含+-号）决定基数。0x|0X-16进制 0-8进制 其它-10进制 */ INT GetProfileInt( LPCTSTR lpAppName, LPCTSTR lpKeyName, INT nDefault ); /* 功能：从配置文件中获取该区的所有键名及键值 参数： lpAppName：分区名 lpReturnedString：结果存放区 nSize：存放区大小（字符数） 返回值： -1：要检索的内存映射文件不存在 -2：参数错误 >=0：拷贝的字符个数 */ INT GetProfileSection( LPCTSTR lpAppName, LPTSTR lpReturnedString, DWORD nSize ); /* 功能：从配置文件中提取所有的分区名 参数： lpReturnedString：结果存放区 nSize：存放区大小（字符数） 返回值： -1：要检索的内存映射文件不存在 -2：参数错误 >=0：拷贝的字符个数 */ INT GetProfileSectionNames( LPTSTR lpReturnedString, DWORD nSize ); /* 功能：更新配置文件区名、键名或者键值 参数： lpAppName：分区名 lpKeyName：键名，如果为NULL或者空串，则删除整个分区 lpString：键值字符串。如果为NULL，则删除该键 返回值： TRUE：成功 FALSE：失败 */ BOOL WriteProfileString( LPCTSTR lpAppName, LPCTSTR lpKeyName, LPCTSTR lpString ); /* 功能：替换指定分区名的键名及键值 参数： lpAppName：分区名 lpString：键名键值字符串 返回： TRUE：成功 FALSE：失败 */ BOOL WriteProfileSection( LPCTSTR lpAppName, LPCTSTR lpString ); /* 功能：将结构数据写入指定键值 参数： lpszSection：分区名 lpszKey：键名 lpStruct：结构体指针 uSizeStruct：结构体大小（字节数） 返回值： TRUE：成功 FALSE：失败 */ BOOL WriteProfileStruct( LPCTSTR lpszSection, LPCTSTR lpszKey, LPVOID lpStruct, UINT uSizeStruct ); /* 功能：从指定键值中读入结构数据 参数： lpszSection：分区名 lpszKey：键名 lpStruct：接收数据的结构体指针 uSizeStruct：结构体大小（字节数） 返回值： TRUE：成功 FALSE：失败 */ BOOL GetProfileStruct( LPCTSTR lpszSection, LPCTSTR lpszKey, LPVOID lpStruct, UINT uSizeStruct ); public: /* 功能：判断是否是注释字符 说明：如果行首字符为;或者#，则该行为注释行 */ static BOOL isCommentChar( TCHAR ch ); /* 功能：判断字符是否是空白字符 说明：空格和跳格字符，视为空白字符 */ static BOOL isWhiteSpace( TCHAR ch ); /* 功能：将字节数组转换成16进制字符数组 返回值：字节数组校验和 */ static BYTE ByteArrayToHexChars( const BYTE* pb, UINT uSize, PTCHAR lpString, BOOL isUppercase = TRUE ); /* 功能：将16进制字符数组转换成字节数组 返回值： TRUE：成功 FALSE：失败 */ static BOOL HexCharsToByteArray( const TCHAR* lpString, LPBYTE pb, UINT uSize, LPBYTE pbCheckSum = NULL ); /* 功能：去掉头部和尾部的空格 */ static void TrimString( PTCHAR pTextBegin, PTCHAR pTextEnd, PTCHAR* hNewBegin, PTCHAR* hNewEnd ); /* 功能：设置缺省字符串 */ static INT SetDefaultString( LPTSTR lpReturnedString, LPCTSTR lpDefault = NULL ); /* 功能：读取一行文本，确定该行文本的起始点和结束点 返回值： 该行文本的有效字符个数 */ static DWORD ReadLine( PTCHAR pRowBegin, PTCHAR pZoneEnd, PTCHAR* hRowEnd ); /* 功能：计算开始新分区或者增加一个键前需要增加的换行符数目 返回值： 需要的换行符数目 */ static UINT PatchEndofLineNum( PTCHAR pRowBegin, PTCHAR pZoneBegin, BOOL isAddKey = TRUE ); protected: /* 功能：搜索区名 返回值： 返回区名所在的行。如果为NULL，则未找到 */ static PTCHAR SearchAppName( LPCTSTR lpAppName, PTCHAR pRowBegin, PTCHAR pZoneEnd ); /* 功能：提取所有区名 返回值： 有效字符串个数 */ static INT GetAllAppName( PTCHAR pRowBegin, PTCHAR pZoneEnd, LPTSTR lpReturnedString, DWORD nSize ); /* 功能：搜索键名 返回值： 返回键名所在的行。如果为NULL，则未找到 */ static PTCHAR SearchKeyName( LPCTSTR lpKeyName, PTCHAR pZoneBegin, PTCHAR pZoneEnd ); /* 功能：提取所有键名 返回值： 有效字符个数 */ static INT GetAllKeyName( PTCHAR pZoneBegin, PTCHAR pZoneEnd, LPTSTR lpReturnedString, DWORD nSize ); /* 功能：提取键值 返回值： 如果lpReturnedString != NULL，则返回拷贝的键值字符串长度，pKeyValue中存储键值字符串 如果lpReturnedString == NULL，则返回键值数据，nSize为缺省键值 */ static INT GetKeyValue( PTCHAR pRowBegin, PTCHAR pZoneEnd, LPTSTR lpReturnedString, DWORD nSize ); /* 功能：获取分区名下所有的键名及键值 返回值： 有效字符个数 */ static INT GetAllKeyNameAndValue( PTCHAR pRowBegin, PTCHAR pZoneEnd, LPTSTR lpReturnedString, DWORD nSize ); protected: /* 功能：按文件实际大小存储文件 */ BOOL SaveFile( void ); /* 功能：写入行结束符 */ UINT WriteEndofLine( PTCHAR p, UINT uTimes = 1 ); /* 功能：增加区域名称 */ PTCHAR AddAppName( PTCHAR pRowBegin, LPCTSTR lpAppName ); /* 功能：增加键名及键值 */ BOOL AddKeyNameAndValue( PTCHAR pZoneBegin, LPCTSTR lpKeyName, LPCTSTR lpString ); /* 功能：更新键名及键值 */ BOOL UpdateKeyNameAndValue( PTCHAR pZoneBegin, LPCTSTR lpKeyName, LPCTSTR lpString ); /* 功能：删除整个区 */ BOOL DeleteSection( PTCHAR pZoneBegin ); /* 功能：增加新的区名及键值 */ BOOL AddSection( PTCHAR pRowBegin, LPCTSTR lpAppName, LPCTSTR lpString ); protected: HANDLE m_hFile; // 物理文件句柄 HANDLE m_hMapFile; // 内存映射文件句柄 PTCHAR m_pViewFile; // 内存映射文件地址空间 DWORD m_dwFileSize; // 物理文件有效大小，字节数 DWORD m_dwMapSize; // 映射文件大小，字节数 DWORD m_dwAccess; // 文件访问方式：GENERIC_READ、GENERIC_WRITE、GENERIC_READ | GENERIC_WRITE。 BOOL m_isWinStyle; // 是否Windows文件风格，换行符为/r/n，否则为/n private: PTCHAR m_pFileBegin; // 文件内容开头地址 PTCHAR m_pFileEnd; // 文件内容结束地址 PTCHAR m_pFileIndex; // 文件内容索引书签 }; /* ------------------------------ END ------------------------------ */