WinApi操作ini文件

   在我们写的程序当中,总有一些配置信息需要保存下来,以便完成程序的功能,最简单的办法就是将这些信息写入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(); */