对自己建立的INI文件的相关操作函数

INI文件简介:

         在我们写程序时,总有一些配置信息需要保存下来,以便在下一次启动程序完成初始化，这实际上是一种类持久化。将一些信息写入INI文件（initialization file）中,完成程序中界面变量的初始化工作，作为配置信息，可完成简单的持久化支持。

         在程序中经常要用到设置或者其他少量数据的存盘，以便程序在下一次执行的时候可以使用，比如说保存本次程序执行时窗口的位置、大小、一些用户设置的数据等等，在 Dos 下编程的时候，我们一般自己产生一个文件，由自己把这些数据写到文件中，然后在下一次执行的时候再读出来使用。在 Win32 编程中当然你也可以这样干，但 Windows 已经为我们提供了两种方便的办法，那就是使用注册表或者 ini 文件（Profile）来保存少量数据。本文中先介绍一下 .ini 文件的使用。

         ini 文件可以分为几个 Section，每个 Section 的名称用 [] 括起来，在一个 Section 中，可以有很多的 Key，每一个 Key 可以有一个值并占用一行，格式是 Key=value，Win32 对 ini 文件操作的 api 中，有一部分是对win.ini 操作的，有一部分是对用户自定义的 ini 文件操作的。Win.in 和 system.ini 是Windows的两个非常重要的初始化文件，Windows将用户所作的选择以及各种变化的系统信息记录在这两个文件中。System.ini描述了系统硬件的当前状态，Win.ini文件则包含了Windows系统运行环境的当前配置.

Windows提供了API接口用于操作INI文件，其支持的INI文件格式一般如下：

#################################

[SectionName1]
Key1=value1
Key2=value2

[SectionName2]
Key3=value3
Key4=value4

... ...
[SectionNameN]
KeyN1=valueN1
KeyN2=valueN2
#################################
一般一个INI文件可有N个节，每节可有n个键名及值对应，每个键名及其值以等式形式占一行。
一般键的名称可任取，不过建议用有意义的字符及词构成。值一般可为整数和字符串，其它类型要进行转换。
常见的系统配置文件：
C:/boot.ini
C:/WINDOWS/win.ini
C:/WINDOWS/system.ini
C:/WINDOWS/desktop.ini
C:/WINDOWS/Resources/Themes/Windows Classic.theme

注意：字符串存贮在INI文件中时没有引号；
      key和value之间的等号前后不容空格；
      注释以分号“；”开头。

 

由于 Win.ini 文件的重要性和常用性，Win32 中有专门对 Win.ini 进行操作的 api，它们是：

GetProfileInt - 从 Win.ini 文件的某个 Section 取得一个 key 的整数值，它的原形是：

GetProfileInt(

          LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址

          LPCTSTR lpKeyName, // 指向包含 Key 名称的字符串地址

          INT nDefault // 如果 Key 值没有找到，则返回缺省的值是多少

);

如果 Key 值没有找到的话，返回值是 nDefault 指定的缺省值,

如果 Key 中的值是负数，则返回 0，

如果 Key 指定的是数字和字符串的混合，则返回数字部分的值，比如说 x=1234abcd，则返回 1234

GetProfileString - 从 Win.ini 文件的某个 Section取得一个 key 的字符串，它的原形是：

GetProfileString(

LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址

LPCTSTR lpKeyName, // 指向包含 Key 名称的字符串地址

LPCTSTR lpDefault, // 如果 Key 值没有找到，则返回缺省的字符串的地址

LPTSTR lpReturnedString, // 返回字符串的缓冲区地址

DWORD nSize // 缓冲区的长度

);

返回的字符串在缓冲区内，返回的 eax 值是返回的字符串的长度（不包括尾部的0）

GetProfileSection -从 Win.ini 文件中读出整个 Section的内容，它的原形是：

GetProfileSection(

LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址

LPTSTR lpReturnedString, // 返回数据的缓冲区地址

DWORD nSize // 返回数据的缓冲区长度

);

WriteProfileSection - 将一个整个 Section 的值写入 Win.ini 文件的指定 Section中，它的原形是：

WriteProfileSection(

LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址

LPCTSTR lpString // 要写入的数据的地址

);

如果 Win.ini 没有指定的 Section，API 会新建立一个并写入数据，

如果已经存在，则先删除原来 Seciton 中所有的 Key 值然后写入新的。

WriteProfileString - 将一个 Key值写入 Win.ini文件的指定 Section中，它的原形是：

WriteProfileString(

LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址

LPCTSTR lpKeyName, // 指向包含 Key 名称的字符串地址

LPCTSTR lpString // 要写的字符串地址

);

如