API读取写入 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'字符,则统计结束*/


int CTestDlg::CalcCount(void)
{
TCHAR       chSectionNames[2048]={0};       //所有节名组成的字符数组
char * pSectionName; //保存找到的某个节名字符串的首地址
int i;       //i指向数组chSectionNames的某个位置,从0开始,顺序后移
int j=0;      //j用来保存下一个节名字符串的首地址相对于当前i的位置偏移量
int count=0;      //统计节的个数

//CString name;
//char id[20];
::GetPrivateProfileSectionNames(chSectionNames,2048,".\\ex1.ini");   
for(i=0;i<2048;i++,j++)
{
      if(chSectionNames[0]=='\0')
       break;       //如果第一个字符就是0,则说明ini中一个节也没有
      if(chSectionNames[i]=='\0')
      {
       pSectionName=&chSectionNames[i-j]; //找到一个0,则说明从这个字符往前,减掉j个偏移量,
            //就是一个节名的首地址

       j=-1;         //找到一个节名后,j的值要还原,以统计下一个节名地址的偏移量
            //赋成-1是因为节名字符串的最后一个字符0是终止符,不能作为节名

            //的一部分
       /*::GetPrivateProfileString(pSectionName,"id","Error",id,20,".\\ex1.ini");
       name.Format("%s",id);*/   
       //在获取节名的时候可以获取该节中键的值,前提是我们知道该节中有哪些键。
   
       AfxMessageBox(pSectionName);      //把找到的显示出来

       if(chSectionNames[i+1]==0)
       {
         break;      //当两个相邻的字符都是0时,则所有的节名都已找到,循环终止
       }
      }   
  
}

return count;
}

posted @ 2011-11-14 15:42  rookieeeeee  阅读(5670)  评论(0编辑  收藏