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;
}
本文來自CSDN博客,轉載請標明出處:http://blog.csdn.net/rbagglo/archive/2008/07/27/2719814.aspx
在我們寫的程序當中,總有一些配置信息需要保存下來,以便完成程序的功能,最簡單的辦法就是將這些信息寫入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]
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".