WIN32读写INI文件方法

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


ini 文件是文本文件,中间的数据格式一般为: 
[Section1 Name] 
KeyName1=value1 
KeyName2=value2 
...


[Section2 Name] 
KeyName1=value1 
KeyName2=value2


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 系统运行环境的当前配置。由于 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 // 要写的字符串地址 
);


如果 Win.ini 没有指定的 Section,API 会新建 Section,如果没有指定的 Key 则新建一个 Key 并写入数据,如果已经存在,则用字符串代替原来的值。 
以上的 Api 是对 Win.ini 操作的,当然对于我们来说,用的更多的是在程序运行的目录中建立自己的 ini 文件,如果需要对自己的 ini 文件操作,就要用到另一组 Api,这一组 api 和上面的很象,只要把上面一组的 Profile 换成 PrivateProfile(私有的)就可以了,参数中也相应的多了一个 ini 文件名的参数。例如 GetPrivateProfileInt、GetPrivateProfileSection、WritePrivateProfileString 等等, 下面分别介绍:


GetPrivateProfileInt - 从 ini 文件的某个 Section 取得一个 key 的整数值,它的原形是:


GetPrivateProfileInt( 
LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址 
LPCTSTR lpKeyName, // 指向包含 Key 名称的字符串地址 
INT nDefault // 如果 Key 值没有找到,则返回缺省的值是多少 
LPCTSTR lpFileName // ini 文件的文件名 
);


中间参数和返回值的定义和 GetProfileInt 是一样的。




GetPrivateProfileString - 从 ini 文件的某个 Section 取得一个 key 的字符串,它的原形是:


GetPrivateProfileString( 
LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址 
LPCTSTR lpKeyName, // 指向包含 Key 名称的字符串地址 
LPCTSTR lpDefault, // 如果 Key 值没有找到,则返回缺省的字符串的地址 
LPTSTR lpReturnedString, // 返回字符串的缓冲区地址 
DWORD nSize // 缓冲区的长度 
LPCTSTR lpFileName // ini 文件的文件名 
);




GetPrivateProfileSection - 从 ini 文件中读出整个 Section 的内容,它的原形是:


GetPrivateProfileSection( 
LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址 
LPTSTR lpReturnedString, // 返回数据的缓冲区地址 
DWORD nSize // 返回数据的缓冲区长度 
LPCTSTR lpFileName // ini 文件的文件名 
);


这个 api 可以读出整个 section 的内容,当你不知道 section 中有哪些 key 的时候,可以使用这个 api 将整个 section 读出后再处理。




GetPrivateProfileSectionNames - 从 ini 文件中获得 Section 的名称,它的原形是:


GetPrivateProfileSectionNames( 
LPTSTR lpszReturnBuffer, // 返回数据的缓冲区地址 
DWORD nSize // 返回数据的缓冲区长度 
LPCTSTR lpFileName // ini 文件的文件名 
);


如果 ini 中有两个 Section: [sec1] 和 [sec2],则返回的是 'sec1',0,'sec2',0,0 ,当你不知道 ini 中有哪些 section 的时候可以用这个 api 来获取名称




WritePrivateProfileSection - 将一个整个 Section 的内容写入 ini 文件的指定 Section 中,它的原形是:


WritePrivateProfileSection( 
LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址 
LPCTSTR lpString // 要写入的数据的地址 
LPCTSTR lpFileName // ini 文件的文件名 
);




WritePrivateProfileString - 将一个 Key 值写入 ini 文件的指定 Section 中,它的原形是:


WritePrivateProfileString( 
LPCTSTR lpAppName, // 指向包含 Section 名称的字符串地址 
LPCTSTR lpKeyName, // 指向包含 Key 名称的字符串地址 
LPCTSTR lpString // 要写的字符串地址 
LPCTSTR lpFileName // ini 文件的文件名 
);


如果 ini 中没有指定的 Section,API 会新建 Section,如果没有指定的 Key 则新建一个 Key 并写入数据,如果已经存在,则用字符串代替原来的值。当指定的 ini 也不存在的时候,API 会自动建立一个新的文件,所以使用 ini 的好处是我们不必为了保存少量的数据涉及到文件操作,就连查找文件是否存在的操作都不必要。


使用要点:


在我们实际使用的时候,用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString,但在对自定义 ini 文件操作的时候要注意的是,如果 lpFileName 指定的文件没有路径的话,Api 会去 Windows 的安装目录去找而不会在当前目录找,但是每次用到 ini 函数要获取当前路径显然太麻烦了,这里有一个变通的办法,你只要在 ini 文件名前面加上 . 就可以了,比如说要对本目录下的 user.ini 操作,那么文件名就是 '.user.ini' 这样显然比较方便。另外,当你要把一个 Key 清除的时候,可以使用把 lpString 指向一个空的字符串然后使用 WritePrivateProfileString。当你要把一个 section 的全部内容清空的时候,也不必把 key 一个个的清除,可以使用把 lpString 指向一个空的字符串然后使用 WritePrivateProfileSection。




INI文件就是扩展名为“ini”的文件。在Windows系统中,INI文件是很多,最重要的就是“System.ini”、 “System32.ini”和“Win.ini”。该文件主要存放用户所做的选择以及系统的各种参数。用户可以通过修改INI文件,来改变应用程序和系 统的很多配置。但自从Windows 95的退出,在Windows系统中引入了注册表的概念,INI文件在Windows系统的地位就开始不断下滑,这是因为注册表的独特优点,使应用程序和 系统都把许多参数和初始化信息放进了注册表中。




读写配置文件注意事项:


#include<windows.h>


如果是Unicode的需要LPCWSTR + _T()


如果是大字符集需要LPCSTR


纯C++方式读写ini文件方式→链接:
原文地址:https://www.cnblogs.com/lvdongjie/p/4619057.html