什么是ini文件? initialization File,即為初始化文件,是windows的系統(tǒng)配置文件所采用的存儲格式,統(tǒng)管windows的各項配置。或者作為項目中的配置文件,為整個項目所共用。 文件格式為 節(jié)、鍵、值。其中節(jié)為[Section name], 參數(shù)為 key(鍵)=value(值)。 ini文件中注解使用分號表示(;),在分號后面的文字,直到該行結尾都全部為注解。 [Section Name]用來表示一個段落,INI文件可能是項目中共用的,所以使用[Section Name]段名來區(qū)分不同用途的參數(shù)區(qū)。key就用來表示參數(shù)名,value表示對應的值。 ini文件讀 1、從系統(tǒng)的win.ini文件中讀取信息 (1) 讀取字符串 DWORD GetProfileString( LPCTSTR lpAppName, // 節(jié)名【不區(qū)分大小寫】 LPCTSTR lpKeyName, // 鍵名,讀取該鍵的值【不區(qū)分大小寫】 LPCTSTR lpDefault, // 若指定的鍵不存在,該值作為讀取的默認值 LPTSTR lpReturnedString, // 一個指向緩沖區(qū)的指針,接收讀取的字符串 DWORD nSize // 指定lpReturnedString指向的緩沖區(qū)的大小 ) 如: CString str; ::GetProfileString("Test","id","Error",str.GetBuffer(20),20); (2) 讀取整數(shù) UINT GetProfileInt( LPCTSTR lpAppName, // 同上 LPCTSTR lpKeyName, // 同上 INT nDefault // 若指定的鍵名不存在,該值作為讀取的默認值 ) 2 從自己的ini文件中讀取信息 函數(shù)原型 DWORD GetPrivateProfileString(string lpszSection,string lpszKey,string lpszDefault, lpszReturnBuffer, cchReturnBuffer, lpszFile) GetPrivateProfileString("DBInfo","IP","",IP.GetBuffer(MAX_PATH),MAX_PATH,iniFilePath);【測過】 CString IP, iniFilePath. GetPrivateProfileString(Section name,key,"",key.GetBuffer(MAX_PATH),MAX_PATH,ini文件路徑+文件名); 其中第一個參數(shù)為段名,第二個參數(shù)為參數(shù)名稱,第三個參數(shù)為沒找到key返回的默認值,第四個參數(shù)為指定一個字串緩沖區(qū),第五個參數(shù)為指定裝載到lpReturnedString緩沖區(qū)的最大字符數(shù)量,第六個參數(shù)為初始化文件的名字,如沒有指定一個完整路徑名,windows就在Windows目錄中查找文件。 __inline DWORD GetPrivateProfileString( LPCTSTR lpAppName, LPCTSTR lpKeyName, LPCTSTR lpDefault, LPTSTR lpReturnedString, DWORD nSize, LPCTSTR lpFileName ) DWORDGetPrivateProfileInt (string lpszSection,string lpszKey,long lpszDefault, lpszFile) 為初始化文件中指定的條目獲取一個整數(shù)值,參數(shù)列表跟上文取String一致,而第三個參數(shù)是如果找不到則返回一個默認的long類型的值。 特別注意的是 如果找到的數(shù)字不是一個合法的整數(shù),函數(shù)會返回其中合法的一部分。比如“xyz=55zz”這個條目,函數(shù)返回55。 UINT GetPrivateProfileInt( 寫INI文件 1. 把信息寫入系統(tǒng)的win.ini文件 BOOL WriteProfileString( LPCTSTR lpAppName, // 節(jié)的名字,是一個以0結束的字符串 LPCTSTR lpKeyName, // 鍵的名字,是一個以0結束的字符串。若為NULL,則刪除整個節(jié) LPCTSTR lpString // 鍵的值,是一個以0結束的字符串。若為NULL,則刪除對應的鍵 ) 2. 把信息寫入自己定義的.ini文件 BOOL WritePrivateProfileString( LPCTSTR lpAppName, // 同上 LPCTSTR lpKeyName, // 同上 LPCTSTR lpString, // 同上 LPCTSTR lpFileName // 要寫入的文件的文件名。若該ini文件與程序在同一個目錄下,也可使用相對 //路徑,否則需要給出絕度路徑。 ) 如: ::WriteProfileString("Test","id","xym"); //在win.ini中創(chuàng)建一個Test節(jié),并在該節(jié)中創(chuàng)建一個鍵id,其值為xym ::WritePrivateProfileString("Test","id","xym","d:\\vc\\Ex1\\ex1.ini"); //在Ex1目錄下的ex1.ini中創(chuàng)建一個Test節(jié),并在該節(jié)中創(chuàng)建一個鍵id,其值為xym //若Ex1.ini文件與讀寫該文件的程序在同一個目錄下,則上面語句也可寫為: ::WritePrivateProfileString("Test","id","xym",".\\ex1.ini"); 需要注意的是,C系列的語言中,轉義字符'\\'表示反斜線'\'。另外,當使用相對路徑時,\\前的.號不能丟掉了。 在我們的程序設計中經(jīng)常需要對一些參數(shù)進行配置,配置好后還要在下一次啟動仍然有效,那么一個有效的可行辦法就是使用ini文件,也就是Windows初始化文件來保存一些我們的設置,然后讓程序啟動的時候從這個ini文件中讀取相關配置。我們需要做以下的工作。 1.創(chuàng)建此ini文件,Windows對ini文件的操作有專門的函數(shù),我們經(jīng)常用的就是WritePrivateProfileString()和GetPrivateProfileString()了。那么我們在程序的初始化時首先檢查是否存在ini文件,如果不存在則創(chuàng)建一個默認的ini文件。 我們使用CFileFind類查找我們需要的ini文件是否存在,若不存在則創(chuàng)建一個。WritePrivateProfileString()當ini不存在時會自動創(chuàng)建一個ini文件在指定路徑。
2.在剛才創(chuàng)建的ini文件中賦值,也就是WritePrivateProfileString()中所做的。 3.在需要用到ini文件的地方從ini文件中讀取數(shù)據(jù)。例如:
這樣基本的操作我們就都知道了。下面詳細說明對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個節(jié),每節(jié)可有n個鍵名及值對應,每個鍵名及其值以等式形式占一行。 一般鍵的名稱可任取,不過建議用有意義的字符及詞構成。值一般可為整數(shù)和字符串,其它類型要進行轉換。 常見的系統(tǒng)配置文件: 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)操作系統(tǒng)配置文件Win.ini的函數(shù):
(2)操作用戶自定義配置文件(PrivateProfile.ini)的函數(shù):
注意: (1)使用得最頻繁的是 GetPrivateProfileString 和 WritePrivateProfileString,沒有WriteProfileInt/WritePrivateProfileInt函數(shù)。 (2)Get系列讀取節(jié)鍵值,如果文件路徑有誤或節(jié)鍵名不對則返回設定的默認值。 (3)訪存自定義配置文件時,文件路徑lpFileName必須完整,文件名前面的各級目錄必須存在。如果lpFileName文件路徑不存在,則函數(shù)返回FALSE,GetLastError() = ERROR_PATH_NOT_FOUND。如果路徑正確,但是文件不存在,則該函數(shù)將先創(chuàng)建該文件。如果路徑及文件存在,則在現(xiàn)有ini文件基礎上進行讀寫。 如果 lpFileName 只指定文件名而沒有路徑的話,調用API將會去 Windows 的安裝目錄去查找而不會在當前目錄查找。 (4)要對調用API的模塊(exe)所在目錄下進行配置文件操作,可使用形如“.//config.ini”的相對路徑,注意轉義符。 (5)調用WritePrivateProfileSection,若參數(shù)三 lpString為NULL,則可將對應section的全部內(nèi)容清空;調用WritePrivateProfileString,若參數(shù)三 lpString為NULL,則可將對應key刪除。 跨平臺配置文件 INI文件本質是對文件和字符串的處理,因此在跨平臺項目中的配置文件可以基于<stdio.h>中的標C文件FILE,然后實現(xiàn)像類似以上對節(jié)([Section])、鍵(Key)和值(Value)的字符串讀寫功能。 鑒于XML的樹形描述層次結構性清晰,現(xiàn)在很多軟件都大面積使用XML文件進行配置,如QQ的全局配置文件C:/Program Files/Tencent/QQ/gf-config.xml。java程序的配置文件基本都使用XML格式,C++中并沒有操作XML文件的標準庫。 在C/C++程序中要使用XML做為配置文件,涉及到XML的解析。Windows平臺可使用MsXml對XML進行解析,參考《MsXml創(chuàng)建和解析XML示例》,跨平臺可以考慮自己實現(xiàn),或使用C++ BOOST正則表達式,或選擇Free C or C++ XML Parser Libraries,如XmlParser、TinyXML、CMarkup、libxml等。 CIniFile類 以下提供對Windows操作INI文件的API的簡單封裝類CIniFile。 [cpp]view plaincopy
在VC++中讀寫INI文件 在我們寫的程序當中,總有一些配置信息需要保存下來,以便完成程序的功能,最簡單的辦法就是將這些信息寫入INI文件中,程序初始化時再讀入.具體應用如下: 一.將信息寫入.INI文件中. 1.所用的WINAPI函數(shù)原型為:
其中各參數(shù)的意義: LPCTSTR lpAppName 是INI文件中的一個字段名. LPCTSTR lpKeyName 是lpAppName下的一個鍵名,通俗講就是變量名. LPCTSTR lpString 是鍵值,也就是變量的值,不過必須為LPCTSTR型或CString型的. LPCTSTR lpFileName 是完整的INI文件名. 2.具體使用方法:設現(xiàn)有一名學生,需把他的姓名和年齡寫入 c:\stud\student.ini 文件中.
此時c:\stud\student.ini文件中的內(nèi)容如下: [StudentInfo] Name=張三 3.要將學生的年齡保存下來,只需將整型的值變?yōu)樽址图纯?
二.將信息從INI文件中讀入程序中的變量. 1.所用的WINAPI函數(shù)原型為:
其中各參數(shù)的意義: 前二個參數(shù)與 WritePrivateProfileString中的意義一樣. lpDefault : 如果INI文件中沒有前兩個參數(shù)指定的字段名或鍵名,則將此值賦給變量. lpReturnedString : 接收INI文件中的值的CString對象,即目的緩存器. nSize : 目的緩存器的大小. lpFileName : 是完整的INI文件名. 2.具體使用方法:現(xiàn)要將上一步中寫入的學生的信息讀入程序中.
執(zhí)行后 strStudName 的值為:"張三",若前兩個參數(shù)有誤,其值為:"默認姓名". 3.讀入整型值要用另一個WINAPI函數(shù):
這里的參數(shù)意義與上相同.使用方法如下:
三.循環(huán)寫入多個值,設現(xiàn)有一程序,要將最近使用的幾個文件名保存下來,具體程序如下: 1.寫入:
2.讀出:
補充四點: 1.INI文件的路徑必須完整,文件名前面的各級目錄必須存在,否則寫入不成功,該函數(shù)返回 FALSE 值. 2.文件名的路徑中必須為 \\ ,因為在VC++中, \\ 才表示一個 \ . 3.也可將INI文件放在程序所在目錄,此時 lpFileName 參數(shù)為: ".\\student.ini". 4.從網(wǎng)頁中粘貼源代碼時,最好先粘貼至記事本中,再往VC中粘貼,否則易造成編譯錯誤,開始時我也十分不解,好好的代碼怎么就不對呢?后來才找到這個方法.還有一些代碼中使用了全角字符如:<,\等,也會 造成編譯錯誤. ============ VC中用函數(shù)讀寫ini文件的方法 ini文件(即Initialization file),這種類型的文件中通常存放的是一個程序的初始化信息。ini文件由若干個節(jié)(Section)組成,每個Section由若干鍵(Key)組成,每個Key可以賦相應的值。讀寫ini文件實際上就是讀寫某個的Section中相應的Key的值,而這只要借助幾個函數(shù)即可完成。 一、向ini文件中寫入信息的函數(shù) 1. 把信息寫入系統(tǒng)的win.ini文件 BOOL WriteProfileString( LPCTSTR lpAppName, // 節(jié)的名字,是一個以0結束的字符串 LPCTSTR lpKeyName, // 鍵的名字,是一個以0結束的字符串。若為NULL,則刪除整個節(jié) LPCTSTR lpString // 鍵的值,是一個以0結束的字符串。若為NULL,則刪除對應的鍵 ) 2. 把信息寫入自己定義的.ini文件 BOOL WritePrivateProfileString( LPCTSTR lpAppName, // 同上 LPCTSTR lpKeyName, // 同上 LPCTSTR lpString, // 同上 LPCTSTR lpFileName // 要寫入的文件的文件名。若該ini文件與程序在同一個目錄下,也可使用相對 //路徑,否則需要給出絕度路徑。 ) 如: ::WriteProfileString("Test","id","xym"); //在win.ini中創(chuàng)建一個Test節(jié),并在該節(jié)中創(chuàng)建一個鍵id,其值為xym ::WritePrivateProfileString("Test","id","xym","d://vc//Ex1//ex1.ini"); //在Ex1目錄下的ex1.ini中創(chuàng)建一個Test節(jié),并在該節(jié)中創(chuàng)建一個鍵id,其值為xym //若Ex1.ini文件與讀寫該文件的程序在同一個目錄下,則上面語句也可寫為: ::WritePrivateProfileString("Test","id","xym",".//ex1.ini"); 需要注意的是,C系列的語言中,轉義字符'//'表示反斜線'/'。另外,當使用相對路徑時,//前的.號不能丟掉了。 二、從ini文件中讀取數(shù)據(jù)的函數(shù) 1、從系統(tǒng)的win.ini文件中讀取信息 (1) 讀取字符串 DWORD GetProfileString( LPCTSTR lpAppName, // 節(jié)名 LPCTSTR lpKeyName, // 鍵名,讀取該鍵的值 LPCTSTR lpDefault, // 若指定的鍵不存在,該值作為讀取的默認值 LPTSTR lpReturnedString, // 一個指向緩沖區(qū)的指針,接收讀取的字符串 DWORD nSize // 指定lpReturnedString指向的緩沖區(qū)的大小 ) 如: CString str; ::GetProfileString("Test","id","Error",str.GetBuffer(20),20); (2) 讀取整數(shù) UINT GetProfileInt( LPCTSTR lpAppName, // 同上 LPCTSTR lpKeyName, // 同上 INT nDefault // 若指定的鍵名不存在,該值作為讀取的默認值 ) 如使用以下語句寫入了年齡信息: ::WriteProfileString("Test","age","25"); //在win.ini中創(chuàng)建一個Test節(jié),并在該節(jié)中創(chuàng)建一個鍵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) 讀取整數(shù) UINT GetPrivateProfileInt( LPCTSTR lpAppName, // 同上 LPCTSTR lpKeyName, // 同上 INT nDefault, // 若指定的鍵名不存在,該值作為讀取的默認值 LPCTSTR lpFileName // 同上 ) 如使用以下語句寫入了年齡信息: ::WritePrivateProfileString("Test","age","25",".//ex1.ini"); //在ex1.ini中創(chuàng)建一個Test節(jié),并在該節(jié)中創(chuàng)建一個鍵age,其值為25 則可用以下語句讀取age鍵的值: int age; age=::GetPrivateProfileInt("Test","age",0,".//ex1.ini"); 三、 刪除鍵值或節(jié) 回顧一下WriteProfileString函數(shù)的說明 BOOL WriteProfileString( LPCTSTR lpAppName, // 節(jié)的名字,是一個以0結束的字符串 LPCTSTR lpKeyName, // 鍵的名字,是一個以0結束的字符串。若為NULL,則刪除整個節(jié) LPCTSTR lpString // 鍵的值,是一個以0結束的字符串。若為NULL,則刪除對應的鍵 ) 由此可見,要刪除某個節(jié),只需要將WriteProfileString第二個參數(shù)設為NULL即可。而要刪除某個鍵,則只需要將該函數(shù)的第三個參數(shù)設為 NULL即可。這是刪除系統(tǒng)的win.ini中的節(jié)或鍵,類似的,要刪除自己定義的ini文件中的節(jié)或鍵,也可做相同的操作。 如: ::WriteProfileString("Test",NULL,NULL); //刪除win.ini中的Test節(jié) ::WriteProfileString("Test","id",NULL); //刪除win.ini中的id鍵 ::WritePrivateProfileString("Test",NULL,NULL,".//ex1.ini"); //刪除ex1.ini中的Test節(jié) ::WritePrivateProfileString("Test","id",NULL,".//ex1.ini"); //刪除ex1.ini中的id鍵 四、如何判斷一個ini文件中有多少個節(jié) 要判斷一個ini文件中有多少個節(jié),最簡單的辦法就是將所有的節(jié)名都找出來,然后統(tǒng)計節(jié)名的個數(shù)。而要將所有的節(jié)名找出來,使用GetPrivateProfileSectionNames函數(shù)就可以了,其原型如下: DWORD GetPrivateProfileSectionNames( LPTSTR lpszReturnBuffer, // 指向一個緩沖區(qū),用來保存返回的所有節(jié)名 DWORD nSize, // 參數(shù)lpszReturnBuffer的大小 LPCTSTR lpFileName // 文件名,若該ini文件與程序在同一個目錄下, //也可使用相對路徑,否則需要給出絕度路徑 ) 下面的是用來統(tǒng)計一個ini文件中共有多少個節(jié)的函數(shù),當然,如果需要同時找到每個節(jié)中的各個鍵及其值,根據(jù)找到節(jié)名就可以很容易的得到了。 /*統(tǒng)計共有多少個節(jié) 節(jié)名的分離方法:若chSectionNames數(shù)組的第一字符是'/0'字符,則表明 有0個節(jié)。否則,從chSectionNames數(shù)組的第一個字符開始,順序往后找, 直到找到一個'/0'字符,若該字符的后繼字符不是 '/0'字符,則表明前 面的字符組成一個節(jié)名。若連續(xù)找到兩個'/0'字符,則統(tǒng)計結束*/ int CTestDlg::CalcCount(void) { TCHAR chSectionNames[2048]={0}; //所有節(jié)名組成的字符數(shù)組 char * pSectionName; //保存找到的某個節(jié)名字符串的首地址 int i; //i指向數(shù)組chSectionNames的某個位置,從0開始,順序后移 int j=0; //j用來保存下一個節(jié)名字符串的首地址相對于當前i的位置偏移量 int count=0; //統(tǒng)計節(jié)的個數(shù) //CString name; //char id[20]; ::GetPrivateProfileSectionNames(chSectionNames,2048,".//ex1.ini"); for(i=0;i<2048;i++,j++) { if(chSectionNames[0]=='/0') break; //如果第一個字符就是0,則說明ini中一個節(jié)也沒有 if(chSectionNames[i]=='/0') { pSectionName=&chSectionNames[i-j]; //找到一個0,則說明從這個字符往前,減掉j個偏移量, //就是一個節(jié)名的首地址 j=-1; //找到一個節(jié)名后,j的值要還原,以統(tǒng)計下一個節(jié)名地址的偏移量 //賦成-1是因為節(jié)名字符串的最后一個字符0是終止符,不能作為節(jié)名 //的一部分 /*::GetPrivateProfileString(pSectionName,"id","Error",id,20,".//ex1.ini"); name.Format("%s",id);*/ //在獲取節(jié)名的時候可以獲取該節(jié)中鍵的值,前提是我們知道該節(jié)中有哪些鍵。 AfxMessageBox(pSectionName); //把找到的顯示出來 if(chSectionNames[i+1]==0) { break; //當兩個相鄰的字符都是0時,則所有的節(jié)名都已找到,循環(huán)終止 } } } return count; } ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////// 在VC程序中利用系統(tǒng)提供的GetPrivateProfileString及WritePrivateProfileString函數(shù)直接讀寫系統(tǒng)配置ini文件(指定目錄下的Ini文件) 假設在當前目錄下有一個文件名為Tets.ini的文件 1.寫INI文件 CString strSection = "Section1"; strFilePath=GetCurrentDirectory(256,strBuff); //獲取當前路徑 GetDlgItemText(IDC_EDIT_NAME,strValue); //獲取文本框內(nèi)容:即姓名 strSectionKey="Item2"; 2.讀INI文件內(nèi)容 strFilePath=GetCurrentDirectory(256,strBuff); //獲取當前路徑 GetPrivateProfileString(strSection,strSectionKey,NULL,strBuff,80,strFilePath); //讀取ini文件中相應字段的內(nèi)容 strSectionKey="Item2"; UpdateData(FALSE); |
|