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

来源:互联网 发布:撤销网络问政的投诉 编辑:程序博客网 时间:2024/06/02 07:31

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文件中没有引号;
      keyvalue的等号前后不容空格;
      以分号“;”开头

 

由于 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 并写入数据,如果已经存在,则用字符串代替原来的值。

 

对于我们来说,用的更多的是在程序运行的目录中建立自己的 ini 文件,如果需要对自己的 ini 文件操作,就要用到另一组 Api,这一组 api 和上面的很象,只要把Win.ini一组的 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 的好处是我们不必为了保存少量的数据涉及到文件操作,就连查找文件是否存在的操作都不必要。

 

使用要点:

1)使用得最繁的是 GetPrivateProfileString WritePrivateProfileString,没有WriteProfileInt/WritePrivateProfileInt函数。
2Get系列节键值,如果文件路径有节键名不对则返回定的默认值
3访存自定配置文件文件路径lpFileName完整,文件名前面的各存在。如果lpFileName文件路径不存在,函数返回FALSEGetLastError() = ERROR_PATH_NOT_FOUND。如果路径正确,但是文件不存在,则该函数将先文件。如果路径及文件存在,ini文件基写。
如果 lpFileName只指定文件名而没有路径的API将会去 Windows 的安装目找而不会在当前目录查找。
4)要对调API的模(exe)所在目行配置文件操作,可使用形如“.//config.ini”的相路径,注意转义符。
5WritePrivateProfileSection,若参数三 lpStringNULL可将对应section的全部内容清空;WritePrivateProfileString,若参数三 lpStringNULL可将对应key除。

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

 

INI文件本文件和字符串的理,因此在跨平台目中的配置文件可以基于<stdio.h>中的C文件FILE,然后实现似以上对节[Section])、Key)和Value)的字符串写功能。

CIniFile
   
以下提供Windows操作INI文件的API简单封装CIniFile
 


VC++INI文件
在我写的程序当中,有一些配置信息需要保存下来,以便完成程序的功能,简单法就是将些信息写入INI文件中,程序初始化.具体用如下:

.将信息写入.INI文件中.

1.
所用的WINAPI函数原型:
  BOOL WritePrivateProfileString(
      LPCTSTR lpAppName,  // INI文件中的一个字段名.
      LPCTSTR lpKeyName,  // lpAppName下的一个,通俗就是量名.
      LPCTSTR lpString,         //键值,也就是量的,须为LPCTSTR型或CString型的.
      LPCTSTR lpFileName    //完整的INI文件名.
  );

2.
具体使用方法:设现有一名学生,需把他的姓名和年写入 c:\stud\student.ini 文件中.
      CString  strName, strTemp;
     int  nAge;
     strName = "";
     nAge = 12;
      
::WritePrivateProfileString("StudentInfo","Name",strName,"c:\\stud\\student.ini");

c:\stud\student.ini文件中的内容如下:

     [StudentInfo]
     Name=

3.
要将学生的年保存下来,只需将整型的值变为字符型即可:
      strTemp.Format("%d",nAge);
      ::WritePrivateProfileString("StudentInfo","Age",strTemp,"c:\\stud\\student.ini");

.将信息从INI文件中入程序中的.

1.
所用的WINAPI函数原型:
    DWORD GetPrivateProfileString(
       
LPCTSTR lpAppName,
        LPCTSTR lpKeyName,
        LPCTSTR lpDefault,
        LPTSTR lpReturnedString,
        DWORD nSize,
        LPCTSTR lpFileName
    );
其中各参数的意:
   前二个参数与 WritePrivateProfileString中的意.
   lpDefault :如果INI文件中没有前两个参数指定的字段名或,将此值赋给变.
   lpReturnedString :接收INI文件中的CString即目的存器.
   nSize : 目的存器的大小.
   lpFileName :是完整的INI文件名.

2. 具体使用方法:要将上一中写入的学生的信息入程序中.
   
CString strStudName;
   
int nStudAge;
    GetPrivateProfileString( "StudentInfo", "Name", "姓名", strStudName.GetBuffer(MAX_PATH), MAX_PATH, "c:\\stud\\student.ini");

行后 strStudName值为:"",若前两个参数有,值为:"姓名".

3.
入整型要用另一个WINAPI函数:
    UINT GetPrivateProfileInt(
       
LPCTSTR lpAppName,
        LPCTSTR lpKeyName,
        INT nDefault,
        LPCTSTR lpFileName
    );
里的参数意与上相同.使用方法如下:
nStudAge=GetPrivateProfileInt("StudentInfo", "Age", 10, "c:\\stud\\student.ini");

.写入多个,设现有一程序,要将最近使用的几个文件名保存下来,具体程序如下:

1.
写入:
    CString strTemp,strTempA;
    int i;
    int nCount=6;
    file://共有6个文件名需要保存
    for(i=0;i {strTemp.Format("%d",i);
    strTempA=文件名;
    file://文件名可以从数,列表框等取得.
    ::WritePrivateProfileString("UseFileName","FileName"+strTemp,strTempA,
    "c:\\usefile\\usefile.ini");
}
strTemp.Format("%d",nCount);
::WritePrivateProfileString("FileCount","Count",strTemp,"c:\\usefile\\usefile.ini");
file://
将文件数写入,以便.

2. :
nCount=::GetPrivateProfileInt("FileCount","Count",0,"c:\\usefile\\usefile.ini");
for(i=0;i {strTemp.Format("%d",i);
strTemp="FileName"+strTemp;
::GetPrivateProfileString("CurrentIni",strTemp,"default.fil", strTempA.GetBuffer(MAX_PATH),MAX_PATH,"c:\\usefile\\usefile.ini");

file://
使用strTempA中的内容.
}


充四点:
   1.INI文件的路径必完整,文件名前面的各存在,写入不成功,函数返回 FALSE .
   2.文件名的路径中必须为 \\ ,VC++, \\ 才表示一个 \ .
   3.也可将INI文件放在程序所在目, lpFileName 参数: ".\\student.ini".
   4.从网中粘源代码时,最好先粘事本中,再往VC中粘,易造成编译错误,我也十分不解,好好的代就不?后来才找到个方法.有一些代中使用了全角字符如:<,\等,也会造成编译错误.

VC中用函数读写ini文件的方法

         ini文件(即Initialization file),这种类型的文件中通常存放的是一个程序的初始化信息。ini文件由若干个节(Section)组成,每个Section由若干键(Key)组成,每个Key可以赋相应的值。读写ini文件实际上就是读写某个的Section中相应的Key的值,而这只要借助几个函数即可完成。


一、向ini文件中写入信息的函数

1. 把信息写入系统的win.ini文件
BOOL WriteProfileString(
      LPCTSTR lpAppName, // 节的名字,是一个以0结束的字符串
      LPCTSTR lpKeyName, // 键的名字,是一个以0结束的字符串。若为NULL,则删除整个节
      LPCTSTR lpString       // 键的值,是一个以0结束的字符串。若为NULL,则删除对应的键
)


2. 把信息写入自己定义的.ini文件
BOOL WritePrivateProfileString(
      LPCTSTR lpAppName,      // 同上
      LPCTSTR lpKeyName,      // 同上
      LPCTSTR lpString,       // 同上
      LPCTSTR lpFileName      // 要写入的文件的文件名。若该ini文件与程序在同一个目录下,也可使用相对路径,否则需要给出绝度路径。
)

如:
::WriteProfileString("Test","id","xym");
//在win.ini中创建一个Test节,并在该节中创建一个键id,其值为xym

::WritePrivateProfileString("Test","id","xym","d://vc//Ex1//ex1.ini");
//在Ex1目录下的ex1.ini中创建一个Test节,并在该节中创建一个键id,其值为xym

//若Ex1.ini文件与读写该文件的程序在同一个目录下,则上面语句也可写为:
::WritePrivateProfileString("Test","id","xym",".//ex1.ini");

需要注意的是,C系列的语言中,转义字符'//'表示反斜线'/'。另外,当使用相对路径时,//前的.号不能丢掉了。

二、从ini文件中读取数据的函数

1、从系统的win.ini文件中读取信息
(1) 读取字符串
DWORD GetProfileString(
      LPCTSTR lpAppName,            // 节名
      LPCTSTR lpKeyName,            // 键名,读取该键的值
      LPCTSTR lpDefault,            // 若指定的键不存在,该值作为读取的默认值
      LPTSTR lpReturnedString,      // 一个指向缓冲区的指针,接收读取的字符串
      DWORD nSize                   // 指定lpReturnedString指向的缓冲区的大小
)

如:
CString str;
::GetProfileString("Test","id","Error",str.GetBuffer(20),20);

(2) 读取整数
UINT GetProfileInt(
      LPCTSTR lpAppName,      // 同上
      LPCTSTR lpKeyName,      // 同上
      INT nDefault            // 若指定的键名不存在,该值作为读取的默认值
)

如使用以下语句写入了年龄信息:
::WriteProfileString("Test","age","25");
//在win.ini中创建一个Test节,并在该节中创建一个键age,其值为25

则可用以下语句读取age键的值:
int age;
age=::GetProfileInt("Test","age",0);

2、从自己的ini文件中读取信息
(1) 读取字符串
DWORD GetPrivateProfileString(
      LPCTSTR lpAppName,            // 同1(1)
      LPCTSTR lpKeyName,            // 同1(1)
      LPCTSTR lpDefault,            // 同1(1)
      LPTSTR lpReturnedString,      // 同1(1)
      DWORD nSize,                  // 同1(1)
      LPCTSTR lpFileName            // 读取信息的文件名。若该ini文件与程序在同一个目录下,也可使用相对路径,否则需要给出绝度路径。
)

如:
CString str;
::GetPrivateProfileString("Test","id","Error",str.GetBuffer(20),20,".//ex1.ini");
或:
::GetPrivateProfileString("Test","id","Error",str.GetBuffer(20),20,"d://vc//Ex1//ex1.ini");

(2) 读取整数

UINT GetPrivateProfileInt(
      LPCTSTR lpAppName,      // 同上
      LPCTSTR lpKeyName,      // 同上
      INT nDefault,           // 若指定的键名不存在,该值作为读取的默认值
      LPCTSTR lpFileName      // 同上
)

如使用以下语句写入了年龄信息:
::WritePrivateProfileString("Test","age","25",".//ex1.ini");
//在ex1.ini中创建一个Test节,并在该节中创建一个键age,其值为25

则可用以下语句读取age键的值:
int age;
age=::GetPrivateProfileInt("Test","age",0,".//ex1.ini");


三、 删除键值或节

回顾一下WriteProfileString函数的说明
BOOL WriteProfileString(
      LPCTSTR lpAppName, // 节的名字,是一个以0结束的字符串
      LPCTSTR lpKeyName, // 键的名字,是一个以0结束的字符串。若为NULL,则删除整个节
      LPCTSTR lpString       // 键的值,是一个以0结束的字符串。若为NULL,则删除对应的键
)
由此可见,要删除某个节,只需要将WriteProfileString第二个参数设为NULL即可。而要删除某个键,则只需要将该函数的第三个参数设为 NULL即可。这是删除系统的win.ini中的节或键,类似的,要删除自己定义的ini文件中的节或键,也可做相同的操作。
       如:
::WriteProfileString("Test",NULL,NULL);      //删除win.ini中的Test节
::WriteProfileString("Test","id",NULL);      //删除win.ini中的id键

::WritePrivateProfileString("Test",NULL,NULL,".//ex1.ini");      //删除ex1.ini中的Test节
::WritePrivateProfileString("Test","id",NULL,".//ex1.ini");      //删除ex1.ini中的id键

四、如何判断一个ini文件中有多少个节
       要判断一个ini文件中有多少个节,最简单的办法就是将所有的节名都找出来,然后统计节名的个数。而要将所有的节名找出来,使用GetPrivateProfileSectionNames函数就可以了,其原型如下:
DWORD GetPrivateProfileSectionNames(
      LPTSTR lpszReturnBuffer,      // 指向一个缓冲区,用来保存返回的所有节名
      DWORD nSize,                  // 参数lpszReturnBuffer的大小
      LPCTSTR lpFileName            // 文件名,若该ini文件与程序在同一个目录下,
                       //也可使用相对路径,否则需要给出绝度路径
)

下面的是用来统计一个ini文件中共有多少个节的函数,当然,如果需要同时找到每个节中的各个键及其值,根据找到节名就可以很容易的得到了。
/*统计共有多少个节
节名的分离方法:若chSectionNames数组的第一字符是'/0'字符,则表明
有0个节。否则,从chSectionNames数组的第一个字符开始,顺序往后找,
直到找到一个'/0'字符,若该字符的后继字符不是 '/0'字符,则表明前
面的字符组成一个节名。若连续找到两个'/0'字符,则统计结束
*/

原创粉丝点击