INI 文件的操作
在程序中經(jīng)常要用到設(shè)置或者其他少量數(shù)據(jù)的存盤(pán),以便程序在下一次執(zhí)行的時(shí)候可以使用,比如說(shuō)保存本次程序執(zhí)行時(shí)窗口的位置、大小、一些用戶(hù)設(shè)置的數(shù)據(jù)等等,在 Dos 下編程的時(shí)候,我們一般自己產(chǎn)生一個(gè)文件,由自己把這些數(shù)據(jù)寫(xiě)到文件中,然后在下一次執(zhí)行的時(shí)候再讀出來(lái)使用。在 Win32 編程中當(dāng)然你也可以這樣干,但 Windows 已經(jīng)為我們提供了兩種方便的辦法,那就是使用注冊(cè)表或者 ini 文件(Profile)來(lái)保存少量數(shù)據(jù)。本文中先介紹一下 .ini 文件的使用。?
ini 文件是文本文件,中間的數(shù)據(jù)格式一般為:?
[Section1 Name]?
KeyName1=value1?
KeyName2=value2?
...?
[Section2 Name]?
KeyName1=value1?
KeyName2=value2?
ini 文件可以分為幾個(gè) Section,每個(gè) Section 的名稱(chēng)用 [] 括起來(lái),在一個(gè) Section 中,可以有很多的 Key,每一個(gè) Key 可以有一個(gè)值并占用一行,格式是 Key=value,Win32 對(duì) ini 文件操作的 api 中,有一部分是對(duì) win.ini 操作的,有一部分是對(duì)用戶(hù)自定義的 ini 文件操作的。Win.in 和 system.ini 是Windows的兩個(gè)非常重要的初始化文件,Windows將用戶(hù)所作的選擇以及各種變化的系統(tǒng)信息記錄在這兩個(gè)文件中。System.ini 描述了系統(tǒng)硬件的當(dāng)前狀態(tài),Win.ini 文件則包含了Windows 系統(tǒng)運(yùn)行環(huán)境的當(dāng)前配置。由于 Win.ini 文件的重要性和常用性,Win32 中有專(zhuān)門(mén)對(duì) Win.ini 進(jìn)行操作的 api,它們是:?
GetProfileInt - 從 Win.ini 文件的某個(gè) Section 取得一個(gè) key 的整數(shù)值,它的原形是:?
GetProfileInt(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
INT nDefault // 如果 Key 值沒(méi)有找到,則返回缺省的值是多少?
);?
如果 Key 值沒(méi)有找到的話(huà),返回值是 nDefault 指定的缺省值,如果 Key 中的值是負(fù)數(shù),則返回 0,如果 Key 指定的是數(shù)字和字符串的混合,則返回?cái)?shù)字部分的值,比如說(shuō) x=1234abcd,則返回 1234?
GetProfileString - 從 Win.ini 文件的某個(gè) Section 取得一個(gè) key 的字符串,它的原形是:?
GetProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpDefault, // 如果 Key 值沒(méi)有找到,則返回缺省的字符串的地址?
LPTSTR lpReturnedString, // 返回字符串的緩沖區(qū)地址?
DWORD nSize // 緩沖區(qū)的長(zhǎng)度?
);?
返回的字符串在緩沖區(qū)內(nèi),返回的 eax 值是返回的字符串的長(zhǎng)度(不包括尾部的0)?
GetProfileSection - 從 Win.ini 文件中讀出整個(gè) Section 的內(nèi)容,它的原形是:?
GetProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPTSTR lpReturnedString, // 返回?cái)?shù)據(jù)的緩沖區(qū)地址?
DWORD nSize // 返回?cái)?shù)據(jù)的緩沖區(qū)長(zhǎng)度?
);?
WriteProfileSection - 將一個(gè)整個(gè) Section 的值 寫(xiě)入 Win.ini 文件的指定 Section 中,它的原形是:?
WriteProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)入的數(shù)據(jù)的地址?
);?
如果 Win.ini 沒(méi)有指定的 Section,API 會(huì)新建立一個(gè)并寫(xiě)入數(shù)據(jù),如果已經(jīng)存在,則先刪除原來(lái) Seciton 中所有的 Key 值然后寫(xiě)入新的。?
WriteProfileString - 將一個(gè) Key 值寫(xiě)入 Win.ini 文件的指定 Section 中,它的原形是:?
WriteProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)的字符串地址?
);?
如果 Win.ini 沒(méi)有指定的 Section,API 會(huì)新建 Section,如果沒(méi)有指定的 Key 則新建一個(gè) Key 并寫(xiě)入數(shù)據(jù),如果已經(jīng)存在,則用字符串代替原來(lái)的值。?
以上的 Api 是對(duì) Win.ini 操作的,當(dāng)然對(duì)于我們來(lái)說(shuō),用的更多的是在程序運(yùn)行的目錄中建立自己的 ini 文件,如果需要對(duì)自己的 ini 文件操作,就要用到另一組 Api,這一組 api 和上面的很象,只要把上面一組的 Profile 換成 PrivateProfile(私有的)就可以了,參數(shù)中也相應(yīng)的多了一個(gè) ini 文件名的參數(shù)。例如 GetPrivateProfileInt、GetPrivateProfileSection、WritePrivateProfileString 等等, 下面分別介紹:?
GetPrivateProfileInt - 從 ini 文件的某個(gè) Section 取得一個(gè) key 的整數(shù)值,它的原形是:?
GetPrivateProfileInt(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
INT nDefault // 如果 Key 值沒(méi)有找到,則返回缺省的值是多少?
LPCTSTR lpFileName // ini 文件的文件名?
);?
中間參數(shù)和返回值的定義和 GetProfileInt 是一樣的。?
GetPrivateProfileString - 從 ini 文件的某個(gè) Section 取得一個(gè) key 的字符串,它的原形是:?
GetPrivateProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpDefault, // 如果 Key 值沒(méi)有找到,則返回缺省的字符串的地址?
LPTSTR lpReturnedString, // 返回字符串的緩沖區(qū)地址?
DWORD nSize // 緩沖區(qū)的長(zhǎng)度?
LPCTSTR lpFileName // ini 文件的文件名?
);?
GetPrivateProfileSection - 從 ini 文件中讀出整個(gè) Section 的內(nèi)容,它的原形是:?
GetPrivateProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPTSTR lpReturnedString, // 返回?cái)?shù)據(jù)的緩沖區(qū)地址?
DWORD nSize // 返回?cái)?shù)據(jù)的緩沖區(qū)長(zhǎng)度?
LPCTSTR lpFileName // ini 文件的文件名?
);?
這個(gè) api 可以讀出整個(gè) section 的內(nèi)容,當(dāng)你不知道 section 中有哪些 key 的時(shí)候,可以使用這個(gè) api 將整個(gè) section 讀出后再處理。?
GetPrivateProfileSectionNames - 從 ini 文件中獲得 Section 的名稱(chēng),它的原形是:?
GetPrivateProfileSectionNames(?
LPTSTR lpszReturnBuffer, // 返回?cái)?shù)據(jù)的緩沖區(qū)地址?
DWORD nSize // 返回?cái)?shù)據(jù)的緩沖區(qū)長(zhǎng)度?
LPCTSTR lpFileName // ini 文件的文件名?
);?
如果 ini 中有兩個(gè) Section: [sec1] 和 [sec2],則返回的是 'sec1',0,'sec2',0,0 ,當(dāng)你不知道 ini 中有哪些 section 的時(shí)候可以用這個(gè) api 來(lái)獲取名稱(chēng)?
WritePrivateProfileSection - 將一個(gè)整個(gè) Section 的內(nèi)容入 ini 文件的指定 Section 中,它的原形是:?
WritePrivateProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)入的數(shù)據(jù)的地址?
LPCTSTR lpFileName // ini 文件的文件名?
);?
WritePrivateProfileString - 將一個(gè) Key 值寫(xiě)入 ini 文件的指定 Section 中,它的原形是:?
WritePrivateProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)的字符串地址?
LPCTSTR lpFileName // ini 文件的文件名?
);?
如果 ini 中沒(méi)有指定的 Section,API 會(huì)新建 Section,如果沒(méi)有指定的 Key 則新建一個(gè) Key 并寫(xiě)入數(shù)據(jù),如果已經(jīng)存在,則用字符串代替原來(lái)的值。當(dāng)指定的 ini 也不存在的時(shí)候,API 會(huì)自動(dòng)建立一個(gè)新的文件,所以使用 ini 的好處是我們不必為了保存少量的數(shù)據(jù)涉及到文件操作,就連查找文件是否存在的操作都不必要。?
使用要點(diǎn):?
在我們實(shí)際使用的時(shí)候,用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString,但在對(duì)自定義 ini 文件操作的時(shí)候要注意的是,如果 lpFileName 指定的文件沒(méi)有路徑的話(huà),Api 會(huì)去 Windows 的安裝目錄去找而不會(huì)在當(dāng)前目錄找,但是每次用到 ini 函數(shù)要獲取當(dāng)前路徑顯然太麻煩了,這里有一個(gè)變通的辦法,你只要在 ini 文件名前面加上 .\ 就可以了,比如說(shuō)要對(duì)本目錄下的 user.ini 操作,那么文件名就是 '.\user.ini' 這樣顯然比較方便。另外,當(dāng)你要把一個(gè) Key 清除的時(shí)候,可以使用把 lpString 指向一個(gè)空的字符串然后使用 WritePrivateProfileString。當(dāng)你要把一個(gè) section 的全部?jī)?nèi)容清空的時(shí)候,也不必把 key 一個(gè)個(gè)的清除,可以使用把 lpString 指向一個(gè)空的字符串然后使用 WritePrivateProfileSection。
ini 文件是文本文件,中間的數(shù)據(jù)格式一般為:?
[Section1 Name]?
KeyName1=value1?
KeyName2=value2?
...?
[Section2 Name]?
KeyName1=value1?
KeyName2=value2?
ini 文件可以分為幾個(gè) Section,每個(gè) Section 的名稱(chēng)用 [] 括起來(lái),在一個(gè) Section 中,可以有很多的 Key,每一個(gè) Key 可以有一個(gè)值并占用一行,格式是 Key=value,Win32 對(duì) ini 文件操作的 api 中,有一部分是對(duì) win.ini 操作的,有一部分是對(duì)用戶(hù)自定義的 ini 文件操作的。Win.in 和 system.ini 是Windows的兩個(gè)非常重要的初始化文件,Windows將用戶(hù)所作的選擇以及各種變化的系統(tǒng)信息記錄在這兩個(gè)文件中。System.ini 描述了系統(tǒng)硬件的當(dāng)前狀態(tài),Win.ini 文件則包含了Windows 系統(tǒng)運(yùn)行環(huán)境的當(dāng)前配置。由于 Win.ini 文件的重要性和常用性,Win32 中有專(zhuān)門(mén)對(duì) Win.ini 進(jìn)行操作的 api,它們是:?
GetProfileInt - 從 Win.ini 文件的某個(gè) Section 取得一個(gè) key 的整數(shù)值,它的原形是:?
GetProfileInt(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
INT nDefault // 如果 Key 值沒(méi)有找到,則返回缺省的值是多少?
);?
如果 Key 值沒(méi)有找到的話(huà),返回值是 nDefault 指定的缺省值,如果 Key 中的值是負(fù)數(shù),則返回 0,如果 Key 指定的是數(shù)字和字符串的混合,則返回?cái)?shù)字部分的值,比如說(shuō) x=1234abcd,則返回 1234?
GetProfileString - 從 Win.ini 文件的某個(gè) Section 取得一個(gè) key 的字符串,它的原形是:?
GetProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpDefault, // 如果 Key 值沒(méi)有找到,則返回缺省的字符串的地址?
LPTSTR lpReturnedString, // 返回字符串的緩沖區(qū)地址?
DWORD nSize // 緩沖區(qū)的長(zhǎng)度?
);?
返回的字符串在緩沖區(qū)內(nèi),返回的 eax 值是返回的字符串的長(zhǎng)度(不包括尾部的0)?
GetProfileSection - 從 Win.ini 文件中讀出整個(gè) Section 的內(nèi)容,它的原形是:?
GetProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPTSTR lpReturnedString, // 返回?cái)?shù)據(jù)的緩沖區(qū)地址?
DWORD nSize // 返回?cái)?shù)據(jù)的緩沖區(qū)長(zhǎng)度?
);?
WriteProfileSection - 將一個(gè)整個(gè) Section 的值 寫(xiě)入 Win.ini 文件的指定 Section 中,它的原形是:?
WriteProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)入的數(shù)據(jù)的地址?
);?
如果 Win.ini 沒(méi)有指定的 Section,API 會(huì)新建立一個(gè)并寫(xiě)入數(shù)據(jù),如果已經(jīng)存在,則先刪除原來(lái) Seciton 中所有的 Key 值然后寫(xiě)入新的。?
WriteProfileString - 將一個(gè) Key 值寫(xiě)入 Win.ini 文件的指定 Section 中,它的原形是:?
WriteProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)的字符串地址?
);?
如果 Win.ini 沒(méi)有指定的 Section,API 會(huì)新建 Section,如果沒(méi)有指定的 Key 則新建一個(gè) Key 并寫(xiě)入數(shù)據(jù),如果已經(jīng)存在,則用字符串代替原來(lái)的值。?
以上的 Api 是對(duì) Win.ini 操作的,當(dāng)然對(duì)于我們來(lái)說(shuō),用的更多的是在程序運(yùn)行的目錄中建立自己的 ini 文件,如果需要對(duì)自己的 ini 文件操作,就要用到另一組 Api,這一組 api 和上面的很象,只要把上面一組的 Profile 換成 PrivateProfile(私有的)就可以了,參數(shù)中也相應(yīng)的多了一個(gè) ini 文件名的參數(shù)。例如 GetPrivateProfileInt、GetPrivateProfileSection、WritePrivateProfileString 等等, 下面分別介紹:?
GetPrivateProfileInt - 從 ini 文件的某個(gè) Section 取得一個(gè) key 的整數(shù)值,它的原形是:?
GetPrivateProfileInt(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
INT nDefault // 如果 Key 值沒(méi)有找到,則返回缺省的值是多少?
LPCTSTR lpFileName // ini 文件的文件名?
);?
中間參數(shù)和返回值的定義和 GetProfileInt 是一樣的。?
GetPrivateProfileString - 從 ini 文件的某個(gè) Section 取得一個(gè) key 的字符串,它的原形是:?
GetPrivateProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpDefault, // 如果 Key 值沒(méi)有找到,則返回缺省的字符串的地址?
LPTSTR lpReturnedString, // 返回字符串的緩沖區(qū)地址?
DWORD nSize // 緩沖區(qū)的長(zhǎng)度?
LPCTSTR lpFileName // ini 文件的文件名?
);?
GetPrivateProfileSection - 從 ini 文件中讀出整個(gè) Section 的內(nèi)容,它的原形是:?
GetPrivateProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPTSTR lpReturnedString, // 返回?cái)?shù)據(jù)的緩沖區(qū)地址?
DWORD nSize // 返回?cái)?shù)據(jù)的緩沖區(qū)長(zhǎng)度?
LPCTSTR lpFileName // ini 文件的文件名?
);?
這個(gè) api 可以讀出整個(gè) section 的內(nèi)容,當(dāng)你不知道 section 中有哪些 key 的時(shí)候,可以使用這個(gè) api 將整個(gè) section 讀出后再處理。?
GetPrivateProfileSectionNames - 從 ini 文件中獲得 Section 的名稱(chēng),它的原形是:?
GetPrivateProfileSectionNames(?
LPTSTR lpszReturnBuffer, // 返回?cái)?shù)據(jù)的緩沖區(qū)地址?
DWORD nSize // 返回?cái)?shù)據(jù)的緩沖區(qū)長(zhǎng)度?
LPCTSTR lpFileName // ini 文件的文件名?
);?
如果 ini 中有兩個(gè) Section: [sec1] 和 [sec2],則返回的是 'sec1',0,'sec2',0,0 ,當(dāng)你不知道 ini 中有哪些 section 的時(shí)候可以用這個(gè) api 來(lái)獲取名稱(chēng)?
WritePrivateProfileSection - 將一個(gè)整個(gè) Section 的內(nèi)容入 ini 文件的指定 Section 中,它的原形是:?
WritePrivateProfileSection(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)入的數(shù)據(jù)的地址?
LPCTSTR lpFileName // ini 文件的文件名?
);?
WritePrivateProfileString - 將一個(gè) Key 值寫(xiě)入 ini 文件的指定 Section 中,它的原形是:?
WritePrivateProfileString(?
LPCTSTR lpAppName, // 指向包含 Section 名稱(chēng)的字符串地址?
LPCTSTR lpKeyName, // 指向包含 Key 名稱(chēng)的字符串地址?
LPCTSTR lpString // 要寫(xiě)的字符串地址?
LPCTSTR lpFileName // ini 文件的文件名?
);?
如果 ini 中沒(méi)有指定的 Section,API 會(huì)新建 Section,如果沒(méi)有指定的 Key 則新建一個(gè) Key 并寫(xiě)入數(shù)據(jù),如果已經(jīng)存在,則用字符串代替原來(lái)的值。當(dāng)指定的 ini 也不存在的時(shí)候,API 會(huì)自動(dòng)建立一個(gè)新的文件,所以使用 ini 的好處是我們不必為了保存少量的數(shù)據(jù)涉及到文件操作,就連查找文件是否存在的操作都不必要。?
使用要點(diǎn):?
在我們實(shí)際使用的時(shí)候,用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString,但在對(duì)自定義 ini 文件操作的時(shí)候要注意的是,如果 lpFileName 指定的文件沒(méi)有路徑的話(huà),Api 會(huì)去 Windows 的安裝目錄去找而不會(huì)在當(dāng)前目錄找,但是每次用到 ini 函數(shù)要獲取當(dāng)前路徑顯然太麻煩了,這里有一個(gè)變通的辦法,你只要在 ini 文件名前面加上 .\ 就可以了,比如說(shuō)要對(duì)本目錄下的 user.ini 操作,那么文件名就是 '.\user.ini' 這樣顯然比較方便。另外,當(dāng)你要把一個(gè) Key 清除的時(shí)候,可以使用把 lpString 指向一個(gè)空的字符串然后使用 WritePrivateProfileString。當(dāng)你要把一個(gè) section 的全部?jī)?nèi)容清空的時(shí)候,也不必把 key 一個(gè)個(gè)的清除,可以使用把 lpString 指向一個(gè)空的字符串然后使用 WritePrivateProfileSection。
總結(jié)
- 上一篇: FreeBSD 10 将使用 Clang
- 下一篇: Android—WebView与JS交互