ini配置文件的读写

背景

在安装一些应用程序的时候，我们经常可以其安装目录下看到有 .ini 格式的配置文件，这种格式配置文件是我们比较常见的。在我们自己电脑的系统上也会有，而且还很多。很多系统自带的程序，都会有一个 .ini 格式的配置文件。

为此，Windows还特地提供了相应的WIN32 API函数去对 .ini 格式的配置文件进行读写操作。

函数介绍

// 将一个字符串复制到INI文件的指定的字段中
// 如果函数成功将字符串复制到初始化文件，则返回值不为零。
BOOL WINAPI WritePrivateProfileString(
     _In_ LPCTSTR lpAppName,			// 要复制字符串的字段名称。 
     _In_ LPCTSTR lpKeyName,			// 与字符串关联的键的名称。
     _In_ LPCTSTR lpString,				// 要写入文件的以NULL结尾的字符串
     _In_ LPCTSTR lpFileName			// INI文件的名称
);

// 从INI文件中的指定的字段中获取一个字符串。
// 返回复制到缓冲区的字符数，不包括终止空字符
DWORD WINAPI GetPrivateProfileString(
     _In_  LPCTSTR lpAppName,			// 字段的名称。(NULL 则获取所有内容)
     _In_  LPCTSTR lpKeyName,			// 要检索的键名。
     _In_  LPCTSTR lpDefault,			// 默认字符串。
     _Out_ LPTSTR  lpReturnedString,	// 指向接收检索字符串的缓冲区的指针。
     _In_  DWORD   nSize,				// lpReturnedString参数指向的缓冲区的大小
     _In_  LPCTSTR lpFileName			// INI文件的名称。
);


// 在INI文件中的指定的字段中获取它的整数值
// 返回INI文件中指定键名后的字符串转换后的整数。
UINT WINAPI GetPrivateProfileInt(
     _In_ LPCTSTR lpAppName,			// INI文件中的字段名称。
     _In_ LPCTSTR lpKeyName,			// 	要检索其值的键名
     _In_ INT     nDefault,				// 如果在初始化文件中找不到键名，返回的默认值
     _In_ LPCTSTR lpFileName			// INI文件的名称。 
);

实现过程

首先，我们调用 WritePrivateProfileString 函数创建一个名为Config.ini的INI文件，并添加INFORMATION和OTHER字段；

在INFORMATION字段下，有两个键名分别为name和age的键，其中键名为name中存储的键值是DemonGan，键名为age中存储的键值为18。在OTHER字段中，键名为class的键值为no1。

char szFileName[] = "C:\\Users\\DemonGan\\Desktop\\ReadWriteIniFile_Test\\Debug\\Config.ini";
    // 向INI文件中写入数据
    ::WritePrivateProfileString("INFORMATION", "name", "DemonGan", szFileName);
    ::WritePrivateProfileString("INFORMATION", "age", "18", szFileName);
    ::WritePrivateProfileString("OTHER", "class", "no1", szFileName);

然后，我们调用 GetPrivateProfileString 函数，读取INI文件中的INFORMATION字段下的name键的数据。

// 从INI文件中读取字符串数据
    char szReturnString[MAX_PATH] = {0};
    ::GetPrivateProfileString("INFORMATION", "name", NULL, szReturnString, MAX_PATH, szFileName);
    printf("name=%s\n", szReturnString);

接着，我们调用 GetPrivateProfileInt 函数，读取INI文件中的INFORMATION字段下的age键的数据。

// 从INI文件中读取整型数据
    int iReturnInt = ::GetPrivateProfileInt("INFORMATION", "age", 0, szFileName);
    printf("age=%d\n", iReturnInt);

对于类似age=18的整型数据的读取，我们除了可以使用 GetPrivateProfileInt 函数读取之外，还可以使用 GetPrivateProfileString 函数去读取，只要将获取的字符串转换为整型就可以了。其中，GetPrivateProfileInt 函数也是先调用获取字符串，然后再转换为整型，所以，GetPrivateProfileInt 函数是对 GetPrivateProfileString 函数的封装和拓展。