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(); 

*/