VC操作INI檔案 ,INI檔案操作總結,如何操作INI檔案,INI檔案使用方法小結
INI檔案簡介
在我們寫程式時,總有一些配置資訊需要儲存下來,以便在下一次啟動程式完成初始化,這實際上是一種類持久化。將一些資訊寫入INI檔案(initialization file)中,可完成簡單的持久化支援。
Windows提供了API介面用於操作INI檔案,其支援的INI檔案格式一般如下:
===============================
[Section1]
Key11=value11
Key12=value12
[Section2]
Key21=value21
Key22=value22
...
[SectionN]
KeyN1=valueN1
KeyN2=valueN2
===============================
一般一個INI檔案可有N個節,每節可有n個鍵名及值對應,每個鍵名及其值以等式形式佔一行。
一般鍵的名稱可任取,不過建議用有意義的字元及詞構成。值一般可為整數和字串,其它型別要進行轉換。
常見的系統配置檔案:
C:/boot.ini
C:/WINDOWS/win.ini
C:/WINDOWS/system.ini
C:/WINDOWS/desktop.ini
C:/WINDOWS/Resources/Themes/Windows Classic.theme
注意,字串存貯在INI檔案中時沒有引號;key和value之間的等號前後不容空格;註釋以分號“;”開頭。
VC中操作INI檔案的API
(1)作業系統配置檔案Win.ini的函式:
函式名 |
功能 |
GetProfileSection |
讀取win.ini中指定節lpAppName中所有鍵名及其值。lpReturnedString字串形式如下: Key1=Value1/0Key2=Value2/0…KeyN=ValueN/0/0 |
GetProfileString |
讀取win.ini中指定節lpAppName中鍵名為lpKeyName對應變數的字串值。 |
GetProfileInt |
讀取win.ini中指定節lpAppName中鍵名為lpKeyName對應變數的整數值。 |
WriteProfileSection |
寫(替換)win.ini中指定節lpAppName中的鍵值。 lpString字串形式同GetProfileSection中的lpReturnedString。 |
WriteProfileString |
寫(替換)win.ini中指定節lpAppName中鍵名為lpKeyName對應變數的字串值。 |
(2)操作使用者自定義配置檔案(PrivateProfile.ini)的函式:
函式名 |
功能 |
GetPrivateProfileSectionNames |
讀取lpFileName指定的配置檔案中所有的節名。lpszReturnBuffer字串形式如下: Section1/0Section2/0…SectionN/0/0 |
GetPrivateProfileSection |
同GetProfileSection。 |
GetPrivateProfileString |
同GetProfileString。 |
GetPrivateProfileInt |
同GetProfileInt |
GetPrivateProfileStruct |
須同WritePrivateProfileStruct配套使用。 |
WritePrivateProfileSection |
同WriteProfileSection |
WritePrivateProfileString |
同WriteProfileString |
WritePrivateProfileStruct |
不常用。 |
注意:
(1)使用得最頻繁的是 GetPrivateProfileString 和 WritePrivateProfileString,沒有WriteProfileInt/WritePrivateProfileInt函式。
(2)Get系列讀取節鍵值,如果檔案路徑有誤或節鍵名不對則返回設定的預設值。
(3)訪存自定義配置檔案時,檔案路徑lpFileName必須完整,檔名前面的各級目錄必須存在。如果lpFileName檔案路徑不存在,則函式返回FALSE,GetLastError() = ERROR_PATH_NOT_FOUND。如果路徑正確,但是檔案不存在,則該函式將先建立該檔案。如果路徑及檔案存在,則在現有ini檔案基礎上進行讀寫。
如果 lpFileName 只指定檔名而沒有路徑的話,呼叫API將會去 Windows 的安裝目錄去查詢而不會在當前目錄查詢。
(4)要對呼叫API的模組(exe)所在目錄下進行配置檔案操作,可使用形如“.//config.ini”的相對路徑,注意轉義符。
(5)呼叫WritePrivateProfileSection,若引數三 lpString為NULL,則可將對應section的全部內容清空;呼叫WritePrivateProfileString,若引數三 lpString為NULL,則可將對應key刪除。
跨平臺配置檔案
INI檔案本質是對檔案和字串的處理,因此在跨平臺專案中的配置檔案可以基於<stdio.h>中的標C檔案FILE,然後實現像類似以上對節([Section])、鍵(Key)和值(Value)的字串讀寫功能。
鑑於XML的樹形描述層次結構性清晰,現在很多軟體都大面積使用XML檔案進行配置,如QQ的全域性配置檔案C:/Program Files/Tencent/QQ/gf-config.xml。java程式的配置檔案基本都使用XML格式,C++中並沒有操作XML檔案的標準庫。
CIniFile類
以下提供對Windows操作INI檔案的API的簡單封裝類CIniFile。
// IniFile.h
#ifndef __INIFILE_H__
#define __INIFILE_H__
class CIniFile
{
public:
CIniFile();
CIniFile(LPCTSTR szFileName);
virtual ~CIniFile();
public:
// Attributes
void SetFileName(LPCTSTR szFileName);
public:
// Operations
BOOL SetProfileInt(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName, int nKeyValue);
BOOL SetProfileString(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName, LPCTSTR lpszKeyValue);
DWORD GetProfileSectionNames(CStringArray& strArray); // 返回section數量
int GetProfileInt(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName);
DWORD GetProfileString(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName, CString& szKeyValue);
BOOL DeleteSection(LPCTSTR lpszSectionName);
BOOL DeleteKey(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName);
private:
CString m_szFileName; // .//Config.ini, 如果該檔案不存在,則exe第一次試圖Write時將建立該檔案
UINT m_unMaxSection; // 最多支援的section數(256)
UINT m_unSectionNameMaxSize; // section名稱長度,這裡設為32(Null-terminated)
void Init();
};
#endif
// IniFile.cpp
#include "IniFile.h"
void CIniFile::Init()
{
m_unMaxSection = 512;
m_unSectionNameMaxSize = 33; // 32位UID串
}
CIniFile::CIniFile()
{
Init();
}
CIniFile::CIniFile(LPCTSTR szFileName)
{
// (1) 絕對路徑,需檢驗路徑是否存在
// (2) 以"./"開頭,則需檢驗後續路徑是否存在
// (3) 以"../"開頭,則涉及相對路徑的解析
Init();
// 相對路徑
m_szFileName.Format(".//%s", szFileName);
}
CIniFile::~CIniFile()
{
}
void CIniFile::SetFileName(LPCTSTR szFileName)
{
m_szFileName.Format(".//%s", szFileName);
}
DWORD CIniFile::GetProfileSectionNames(CStringArray &strArray)
{
int nAllSectionNamesMaxSize = m_unMaxSection*m_unSectionNameMaxSize+1;
char *pszSectionNames = new char[nAllSectionNamesMaxSize];
DWORD dwCopied = 0;
dwCopied = ::GetPrivateProfileSectionNames(pszSectionNames, nAllSectionNamesMaxSize, m_szFileName);
strArray.RemoveAll();
char *pSection = pszSectionNames;
do
{
CString szSection(pSection);
if (szSection.GetLength() < 1)
{
delete[] pszSectionNames;
return dwCopied;
}
strArray.Add(szSection);
pSection = pSection + szSection.GetLength() + 1; // next section name
} while (pSection && pSection<pszSectionNames+nAllSectionNamesMaxSize);
delete[] pszSectionNames;
return dwCopied;
}
DWORD CIniFile::GetProfileString(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName, CString& szKeyValue)
{
DWORD dwCopied = 0;
dwCopied = ::GetPrivateProfileString(lpszSectionName, lpszKeyName, "",
szKeyValue.GetBuffer(MAX_PATH), MAX_PATH, m_szFileName);
szKeyValue.ReleaseBuffer();
return dwCopied;
}
int CIniFile::GetProfileInt(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName)
{
int nKeyValue = ::GetPrivateProfileInt(lpszSectionName, lpszKeyName, 0, m_szFileName);
return nKeyValue;
}
BOOL CIniFile::SetProfileString(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName, LPCTSTR lpszKeyValue)
{
return ::WritePrivateProfileString(lpszSectionName, lpszKeyName, lpszKeyValue, m_szFileName);
}
BOOL CIniFile::SetProfileInt(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName, int nKeyValue)
{
CString szKeyValue;
szKeyValue.Format("%d", nKeyValue);
return ::WritePrivateProfileString(lpszSectionName, lpszKeyName, szKeyValue, m_szFileName);
}
BOOL CIniFile::DeleteSection(LPCTSTR lpszSectionName)
{
return ::WritePrivateProfileSection(lpszSectionName, NULL, m_szFileName);
}
BOOL CIniFile::DeleteKey(LPCTSTR lpszSectionName, LPCTSTR lpszKeyName)
{
return ::WritePrivateProfileString(lpszSectionName, lpszKeyName, NULL, m_szFileName);
}
在VC++中讀寫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".
4.從網頁中貼上原始碼時,最好先貼上至記事本中,再往VC中貼上,否則易造成編譯錯誤,開始時我也十分不解,好好的程式碼怎麼就不對呢?後來才找到這個方法.還有一些程式碼中使用了全形字元如:<,\等,也會
造成編譯錯誤.
============
VC中用函式讀寫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;
} ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /////////////////////////////////////////////////////////////////
在VC程式中利用系統提供的GetPrivateProfileString及WritePrivateProfileString函式直接讀寫系統配置ini檔案(指定目錄下的Ini檔案)
假設在當前目錄下有一個檔名為Tets.ini的檔案
用於儲存使用者名稱和密碼
檔案格式如下:
[Section1]
Item1=huzhifeng
Item2=1234565
1.寫INI檔案
void CINI_File_TestDlg::OnButtonWrite()
{
// TODO: Add your control notification handler code here
CString strSection = "Section1";
CString strSectionKey = "Item1";
char strBuff[256];
CString strValue = _T("");
CString strFilePath;
strFilePath=GetCurrentDirectory(256,strBuff); //獲取當前路徑
strFilePath.Format("%s//Test.ini",strBuff);
GetDlgItemText(IDC_EDIT_NAME,strValue); //獲取文字框內容:即姓名
WritePrivateProfileString(strSection,strSectionKey,strValue,strFilePath); //寫入ini檔案中相應欄位
strSectionKey="Item2";
GetDlgItemText(IDC_EDIT_PASSWORD,strValue); //獲取文字框內容:即密碼
WritePrivateProfileString(strSection,strSectionKey,strValue,strFilePath);
}
2.讀INI檔案內容
void CINI_File_TestDlg::OnButtonRead()
{
// TODO: Add your control notification handler code here
CString strSection = "Section1";
CString strSectionKey = "Item1";
char strBuff[256];
CString strValue = _T("");
CString strFilePath;
strFilePath=GetCurrentDirectory(256,strBuff); //獲取當前路徑
strFilePath.Format("%s//Test.ini",strBuff);
GetPrivateProfileString(strSection,strSectionKey,NULL,strBuff,80,strFilePath); //讀取ini檔案中相應欄位的內容
strValue=strBuff;
SetDlgItemText(IDC_EDIT_NAME,strValue);
strSectionKey="Item2";
GetPrivateProfileString(strSection,strSectionKey,NULL,strBuff,80,strFilePath);
strValue=strBuff;
SetDlgItemText(IDC_EDIT_PASSWORD,strValue);
UpdateData(FALSE);
}