用Visual C++操作INI文件

Dear 丶 2022-09-18 10:47 214阅读 0赞

在我们写的程序当中,总有一些配置信息需要保存下来,以便完成程序的功能,最简单的办法就是将这些信息写入INI文件中,程序初始化时再读入.具体应用如下:  
  
　　一.将信息写入.INI文件中.  
  
　　1.所用的WINAPI函数原型为:   
  
BOOL WritePrivateProfileString(  
LPCTSTR lpAppName,  
LPCTSTR lpKeyName,  
LPCTSTR lpString,  
LPCTSTR lpFileName  
);   
  
　　其中各参数的意义:  
  
　　　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".  
  
//----------------------------------------------------------------------------------  
/\*  
 类名：CIni  
 版本：v2.0  
 最后更新：  
 v2.0  
 梦小孩于2004年2月14日情人节  
 加入高级操作的功能  
 v1.0  
 梦小孩于2003年某日  
 一般操作完成  
   
 类描述：  
 本类可以于.ini文件进行操作  
 \*/  
   
文件 1:  
  
\#pragma once  
   
\#include "afxTempl.h"  
   
class CIni  
\{  
private:  
 CString m\_strFileName;  
public:  
 CIni(CString strFileName):m\_strFileName(strFileName)  
 \{  
 \}  
public:  
 //一般性操作：  
 BOOL SetFileName(LPCTSTR lpFileName);  //设置文件名  
 CString GetFileName(void); //获得文件名  
 BOOL SetValue(LPCTSTR lpSection, LPCTSTR lpKey, LPCTSTR lpValue,bool bCreate=true); //设置键值，bCreate是指段名及键名未存在时，是否创建。  
 CString GetValue(LPCTSTR lpSection, LPCTSTR lpKey); //得到键值.  
 BOOL DelSection(LPCTSTR strSection);  //删除段名  
 BOOL DelKey(LPCTSTR lpSection, LPCTSTR lpKey);  //删除键名  
   
  
public:  
 //高级操作：  
 int GetSections(CStringArray& arrSection);  //枚举出全部的段名  
 int GetKeyValues(CStringArray& arrKey,CStringArray& arrValue,LPCTSTR lpSection);  //枚举出一段内的全部键名及值  
   
 BOOL DelAllSections();  
   
\};  
  
文件 2:  
  
\#include "StdAfx.h"  
\#include "ini.h"  
   
\#define MAX\_ALLSECTIONS 2048  //全部的段名  
\#define MAX\_SECTION 260  //一个段名长度  
\#define MAX\_ALLKEYS 6000  //全部的键名  
\#define MAX\_KEY 260  //一个键名长度  
   
BOOL CIni::SetFileName(LPCTSTR lpFileName)  
\{  
 CFile file;  
 CFileStatus status;  
   
 if(!file.GetStatus(lpFileName,status))  
  return TRUE;  
   
 m\_strFileName=lpFileName;  
 return FALSE;  
\}  
   
CString CIni::GetFileName(void)  
\{  
 return m\_strFileName;  
\}  
   
BOOL CIni::SetValue(LPCTSTR lpSection, LPCTSTR lpKey, LPCTSTR lpValue,bool bCreate)  
\{  
 TCHAR lpTemp\[MAX\_PATH\] =\{0\};  
   
 //以下if语句表示如果设置bCreate为false时，当没有这个键名时则返回TRUE（表示出错）  
 //!\*&\*none-value\*&!\* 这是个垃圾字符没有特别意义，这样乱写是防止凑巧相同。  
 if (!bCreate)  
 \{  
  GetPrivateProfileString(lpSection,lpKey,"!\*&\*none-value\*&!\*",lpTemp,MAX\_PATH,m\_strFileName);  
  if(strcmp(lpTemp,"!\*&\*none-value\*&!\*")==0)  
   return TRUE;  
 \}  
   
 if(WritePrivateProfileString(lpSection,lpKey,lpValue,m\_strFileName))  
  return FALSE;  
 else  
  return GetLastError();  
\}  
   
CString CIni::GetValue(LPCTSTR lpSection, LPCTSTR lpKey)  
\{  
 DWORD dValue;  
 TCHAR lpValue\[MAX\_PATH\] =\{0\};  
   
 dValue=GetPrivateProfileString(lpSection,lpKey,"",lpValue,MAX\_PATH,m\_strFileName);  
 return lpValue;  
\}  
   
BOOL CIni::DelSection(LPCTSTR lpSection)  
\{  
 if(WritePrivateProfileString(lpSection,NULL,NULL,m\_strFileName))  
  return FALSE;  
 else  
  return GetLastError();  
\}  
   
BOOL CIni::DelKey(LPCTSTR lpSection, LPCTSTR lpKey)  
\{  
 if(WritePrivateProfileString(lpSection,lpKey,NULL,m\_strFileName))  
  return FALSE;  
 else  
  return GetLastError();  
\}  
   
  
int CIni::GetSections(CStringArray& arrSection)  
\{  
 /\*  
 本函数基础：  
 GetPrivateProfileSectionNames - 从 ini 文件中获得 Section 的名称  
 如果 ini 中有两个 Section: \[sec1\] 和 \[sec2\]，则返回的是 'sec1',0,'sec2',0,0 ，当你不知道    
 ini 中有哪些 section 的时候可以用这个 api 来获取名称   
 \*/  
 int i;    
 int iPos=0;    
 int iMaxCount;  
 TCHAR chSectionNames\[MAX\_ALLSECTIONS\]=\{0\}; //总的提出来的字符串  
 TCHAR chSection\[MAX\_SECTION\]=\{0\}; //存放一个段名。  
 GetPrivateProfileSectionNames(chSectionNames,MAX\_ALLSECTIONS,m\_strFileName);  
   
 //以下循环，截断到两个连续的0  
 for(i=0;i<MAX\_ALLSECTIONS;i++)  
 \{  
  if (chSectionNames\[i\]==0)  
   if (chSectionNames\[i\]==chSectionNames\[i+1\])  
    break;  
 \}  
   
 iMaxCount=i+1; //要多一个0号元素。即找出全部字符串的结束部分。  
 arrSection.RemoveAll();//清空原数组  
   
 for(i=0;i<iMaxCount;i++)  
 \{  
  chSection\[iPos++\]=chSectionNames\[i\];  
  if(chSectionNames\[i\]==0)  
  \{     
   arrSection.Add(chSection);  
   memset(chSection,0,MAX\_SECTION);  
   iPos=0;  
  \}  
   
 \}  
   
 return (int)arrSection.GetSize();  
\}  
   
int CIni::GetKeyValues(CStringArray& arrKey,CStringArray& arrValue, LPCTSTR lpSection)  
\{  
 /\*  
 本函数基础：  
 GetPrivateProfileSection- 从 ini 文件中获得一个Section的全部键名及值名  
 如果ini中有一个段，其下有 "段1=值1" "段2=值2"，则返回的是 '段1=值1',0,'段2=值2',0,0 ，当你不知道    
 获得一个段中的所有键及值可以用这个。   
 \*/  
 int i;    
 int iPos=0;  
 CString strKeyValue;  
 int iMaxCount;  
 TCHAR chKeyNames\[MAX\_ALLKEYS\]=\{0\}; //总的提出来的字符串  
 TCHAR chKey\[MAX\_KEY\]=\{0\}; //提出来的一个键名  
   
 GetPrivateProfileSection(lpSection,chKeyNames,MAX\_ALLKEYS,m\_strFileName);  
   
 for(i=0;i<MAX\_ALLKEYS;i++)  
 \{  
  if (chKeyNames\[i\]==0)  
   if (chKeyNames\[i\]==chKeyNames\[i+1\])  
    break;  
 \}  
   
 iMaxCount=i+1; //要多一个0号元素。即找出全部字符串的结束部分。  
 arrKey.RemoveAll();//清空原数组  
 arrValue.RemoveAll();  
   
 for(i=0;i<iMaxCount;i++)  
 \{  
  chKey\[iPos++\]=chKeyNames\[i\];  
  if(chKeyNames\[i\]==0)  
  \{  
   strKeyValue=chKey;  
   arrKey.Add(strKeyValue.Left(strKeyValue.Find("=")));  
   arrValue.Add(strKeyValue.Mid(strKeyValue.Find("=")+1));  
   memset(chKey,0,MAX\_KEY);  
   iPos=0;  
  \}  
   
 \}  
   
 return (int)arrKey.GetSize();  
\}  
   
BOOL CIni::DelAllSections()  
\{  
 int nSection;  
 CStringArray arrSection;  
 nSection=GetSections(arrSection);  
 for(int i=0;i<nSection;i++)  
 \{  
  if(DelSection(arrSection\[i\]))  
   return GetLastError();  
 \}  
 return FALSE;  
\}  
  
  
使用方法：  
CIni ini("c://a.ini");  
int n;  
  
/\*获得值  
TRACE("%s",ini.GetValue("段1","键1"));  
 \*/  
  
/\*添加值  
ini.SetValue("自定义段","键1","值");  
ini.SetValue("自定义段2","键1","值",false);  
 \*/  
  
/\*枚举全部段名  
CStringArray arrSection;  
n=ini.GetSections(arrSection);  
for(int i=0;i<n;i++)  
TRACE("%s/n",arrSection\[i\]);  
 \*/  
  
/\*枚举全部键名及值  
CStringArray arrKey,arrValue;  
n=ini.GetKeyValues(arrKey,arrValue,"段1");  
for(int i=0;i<n;i++)  
TRACE("键：%s/n值：%s/n",arrKey\[i\],arrValue\[i\]);  
\*/  
  
/\*删除键值  
ini.DelKey("段1","键1");  
\*/  
  
/\*删除段  
ini.DelSection("段1");  
\*/  
  
/\*删除全部  
ini.DelAllSections();  
\*/