操作INI文件函数
操作INI文件的函數(shù)主要有：
?
| 函數(shù)名 | 功能 | 備注 |
| GetPrivateProfileInt?????????????????????? | 讀取INI文件指定塊中的鍵名對應的整數(shù)值。 | ? |
| GetPrivateProfileSection | 記取INI文件指定塊中的所有鍵名及其對應值。 | ? |
| GetPrivateProfileSectionNames | 讀取一INI文件中所有的塊名。 | ? |
| GetPrivateProfileString | 讀取INI文件指定塊中的鍵名對應的字符串。 | ? |
| GetPrivateProfileStruct | 讀取INI文件指定塊中的鍵名對應的數(shù)據(jù) | ? |
| GetProfileInt | 讀取win.ini中指定塊中的鍵名對應的整數(shù)值。 | ? |
| GetProfileSection | 讀取win.ini中指定塊中所有的鍵名及其值。 | ? |
| GetProfileString | 讀取win.ini中指定塊中的鍵名的對應值。 | ? |
| WritePrivateProfileSection | 替換INI文件中指定塊中所有鍵名對應的值。 | ? |
| WritePrivateProfileString | 把給定的鍵名及其值寫入到指定INI文件的相應塊中。 | ? |
| WritePrivateProfileStruct | 把指定的鍵名及其數(shù)據(jù)寫入到指定INI文件的塊中。 | ? |
| WriteProfileSection | 替換win.ini中指定塊的所有鍵名對應的值。 | ? |
| WriteProfileString | 將給定的鍵名及值寫入win.ini中對應的塊中。 | ? |
| ? | ? | ? |
INI文件可用來保存，共享應用程序中少量的數(shù)據(jù)，其格式一般為：
[塊名1]
鍵名=值
...
[塊名n]
鍵名=值
一般一個INI文件可有N個塊，第塊可有n個鍵名及值對應。每個鍵名及其值占一行。
一般鍵的名稱可任取，不過建議用有意義的字符及詞構成。值一般可為整數(shù)和字符串，其它類型要進行轉換。
GetProfileInt - 從 Win.ini 文件的某個 Section 取得一個 key 的整數(shù)值，它的原形是：
GetProfileInt(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
INT nDefault // 如果 Key 值沒有找到，則返回缺省的值是多少
);
如果 Key 值沒有找到的話，返回值是 nDefault 指定的缺省值，如果 Key 中的值是負數(shù)，則返回 0，如果 Key 指定的是數(shù)字和字符串的混合，則返回數(shù)字部分的值，比如說 x=1234abcd，則返回 1234
GetProfileString - 從 Win.ini 文件的某個 Section 取得一個 key 的字符串，它的原形是：
GetProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpDefault, // 如果 Key 值沒有找到，則返回缺省的字符串的地址
LPTSTR lpReturnedString, // 返回字符串的緩沖區(qū)地址
DWORD nSize // 緩沖區(qū)的長度
);
返回的字符串在緩沖區(qū)內(nèi)，返回的 eax 值是返回的字符串的長度（不包括尾部的0）
GetProfileSection - 從 Win.ini 文件中讀出整個 Section 的內(nèi)容，它的原形是：
GetProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPTSTR lpReturnedString, // 返回數(shù)據(jù)的緩沖區(qū)地址
DWORD nSize // 返回數(shù)據(jù)的緩沖區(qū)長度
);
WriteProfileSection - 將一個整個 Section 的值 寫入 Win.ini 文件的指定 Section 中，它的原形是：
WriteProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpString // 要寫入的數(shù)據(jù)的地址
);
如果 Win.ini 沒有指定的 Section，API 會新建立一個并寫入數(shù)據(jù)，如果已經(jīng)存在，則先刪除原來 Seciton 中所有的 Key 值然后寫入新的。
WriteProfileString - 將一個 Key 值寫入 Win.ini 文件的指定 Section 中，它的原形是：
WriteProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpString // 要寫的字符串地址
);
如果 Win.ini 沒有指定的 Section，API 會新建 Section，如果沒有指定的 Key 則新建一個 Key 并寫入數(shù)據(jù)，如果已經(jīng)存在，則用字符串代替原來的值。?
以上的 Api 是對 Win.ini 操作的，當然對于我們來說，用的更多的是在程序運行的目錄中建立自己的 ini 文件，如果需要對自己的 ini 文件操作，就要用到另一組 Api，這一組 api 和上面的很象，只要把上面一組的 Profile 換成 PrivateProfile（私有的）就可以了，參數(shù)中也相應的多了一個 ini 文件名的參數(shù)。例如 GetPrivateProfileInt、GetPrivateProfileSection、WritePrivateProfileString 等等， 下面分別介紹：
GetPrivateProfileInt - 從 ini 文件的某個 Section 取得一個 key 的整數(shù)值，它的原形是：
GetPrivateProfileInt(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
INT nDefault // 如果 Key 值沒有找到，則返回缺省的值是多少
LPCTSTR lpFileName // ini 文件的文件名
);
中間參數(shù)和返回值的定義和 GetProfileInt 是一樣的。
GetPrivateProfileString - 從 ini 文件的某個 Section 取得一個 key 的字符串，它的原形是：
GetPrivateProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpDefault, // 如果 Key 值沒有找到，則返回缺省的字符串的地址
LPTSTR lpReturnedString, // 返回字符串的緩沖區(qū)地址
DWORD nSize // 緩沖區(qū)的長度
LPCTSTR lpFileName // ini 文件的文件名
);
GetPrivateProfileSection - 從 ini 文件中讀出整個 Section 的內(nèi)容，它的原形是：
GetPrivateProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPTSTR lpReturnedString, // 返回數(shù)據(jù)的緩沖區(qū)地址
DWORD nSize // 返回數(shù)據(jù)的緩沖區(qū)長度
LPCTSTR lpFileName // ini 文件的文件名
);
這個 api 可以讀出整個 section 的內(nèi)容，當你不知道 section 中有哪些 key 的時候，可以使用這個 api 將整個 section 讀出后再處理。
說明：
例ini文件為：
[student]
Name=tian
Age=20
Sex=man
由GetPrivateProfileSection（）函數(shù)第二個參數(shù)lpReturnedString?返回的字符串如下：
Name=tian"0Age=20"0Sex=man"0"0（每條以"0分割，最后以兩個"0結束）
而我們是想等到每個key及其對應的值，那怎么分割上面那個字符串呢？在VB有中個叫Split()函數(shù)，用起來很方便，但是vc里面沒有。
當然，你也可以在VC中去實現(xiàn)一個Split()函數(shù)，不過我在這里提供一個簡單的方法：
CString strKey;
???????? while(*str!='"0') //str為lpReturnedString返回的字符串
???????? {???????
?????????????????? strKey = str;
?????????????????? MessageBox(strKey); //strKey為每個key及其對應的值
?????????????????? str += strKey.GetLength()+1;
???????? }
GetPrivateProfileSectionNames - 從 ini 文件中獲得 Section 的名稱，它的原形是：
GetPrivateProfileSectionNames(
LPTSTR lpszReturnBuffer, // 返回數(shù)據(jù)的緩沖區(qū)地址
DWORD nSize // 返回數(shù)據(jù)的緩沖區(qū)長度
LPCTSTR lpFileName // ini 文件的文件名
);
如果 ini 中有兩個 Section: [sec1] 和 [sec2]，則返回的是 'sec1',0,'sec2',0,0 ，當你不知道 ini 中有哪些 section 的時候可以用這個 api 來獲取名稱
WritePrivateProfileSection - 將一個整個 Section 的內(nèi)容入 ini 文件的指定 Section 中，它的原形是：
WritePrivateProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpString // 要寫入的數(shù)據(jù)的地址
LPCTSTR lpFileName // ini 文件的文件名
);
WritePrivateProfileString - 將一個 Key 值寫入 ini 文件的指定 Section 中，它的原形是：
WritePrivateProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpString // 要寫的字符串地址?
LPCTSTR lpFileName // ini 文件的文件名
);
如果 ini 中沒有指定的 Section，API 會新建 Section，如果沒有指定的 Key 則新建一個 Key 并寫入數(shù)據(jù)，如果已經(jīng)存在，則用字符串代替原來的值。當指定的 ini 也不存在的時候，API 會自動建立一個新的文件，所以使用 ini 的好處是我們不必為了保存少量的數(shù)據(jù)涉及到文件操作，就連查找文件是否存在的操作都不必要。
使用要點：
在我們實際使用的時候，用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString，但在對自定義 ini 文件操作的時候要注意的是，如果 lpFileName 指定的文件沒有路徑的話，Api 會去 Windows 的安裝目錄去找而不會在當前目錄找，但是每次用到 ini 函數(shù)要獲取當前路徑顯然太麻煩了，這里有一個變通的辦法，你只要在 ini 文件名前面加上 ." 就可以了，比如說要對本目錄下的 user.ini 操作，那么文件名就是 '."user.ini' 這樣顯然比較方便。另外，當你要把一個 Key 清除的時候，可以使用把 lpString 指向一個空的字符串然后使用 WritePrivateProfileString。當你要把一個 section 的全部內(nèi)容清空的時候，也不必把 key 一個個的清除，可以使用把 lpString 指向一個空的字符串然后使用 WritePrivateProfileSection。
--------------------------------
在我們寫的程序當中,總有一些配置信息需要保存下來,以便完成程序的功能,最簡單的辦法就是將這些信息寫入INI文件中,程序初始化時再讀入.具體應用如下:
一.將信息寫入.INI文件中.
1.所用的WINAPI函數(shù)原型為:
BOOL WritePrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpString,
LPCTSTR lpFileName
); 其中各參數(shù)的意義:
LPCTSTR lpAppName 是INI文件中的一個字段名.
LPCTSTR lpKeyName 是lpAppName下的一個鍵名,通俗講就是變量名.
LPCTSTR lpString 是鍵值,也就是變量的值,不過必須為LPCTSTR型或CString型的.
LPCTSTR lpFileName 是完整的INI文件名.
2.具體使用方法:設現(xiàn)有一名學生,需把他的姓名和年齡寫入 c:"stud"student.ini 文件中.
CString strName,strTemp;
int nAge;
strName="張三";
nAge=12;
::WritePrivateProfileString("StudentInfo","Name",strName,
"c:""stud""student.ini"); 此時c:"stud"student.ini文件中的內(nèi)容如下:
[StudentInfo]
3.要將學生的年齡保存下來,只需將整型的值變?yōu)樽址图纯?
strTemp.Format("%d",nAge);
::WritePrivateProfileString("StudentInfo","Age",strTemp,
"c:""stud""student.ini");二.將信息從INI文件中讀入程序中的變量.
1.所用的WINAPI函數(shù)原型為:
DWORD GetPrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpDefault,
LPTSTR lpReturnedString,
DWORD nSize,
LPCTSTR lpFileName
); 其中各參數(shù)的意義:
前二個參數(shù)與 WritePrivateProfileString中的意義一樣.
lpDefault : 如果INI文件中沒有前兩個參數(shù)指定的字段名或鍵名,則將此值賦給變量.
lpReturnedString : 接收INI文件中的值的CString對象,即目的緩存器.
nSize : 目的緩存器的大小.
lpFileName : 是完整的INI文件名.
2.具體使用方法:現(xiàn)要將上一步中寫入的學生的信息讀入程序中.
CString strStudName;
int nStudAge;
GetPrivateProfileString("StudentInfo","Name","默認姓名",
strStudName.GetBuffer(MAX_PATH),MAX_PATH,"c:""stud""student.ini"); 執(zhí)行后 strStudName 的值為:”張三”,若前兩個參數(shù)有誤,其值為:”默認姓名”.
3.讀入整型值要用另一個WINAPI函數(shù):
UINT GetPrivateProfileInt(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
INT nDefault,
LPCTSTR lpFileName
); 這里的參數(shù)意義與上相同.使用方法如下:
nStudAge=GetPrivateProfileInt("StudentInfo","Age",10,
"c:""stud""student.ini");三.循環(huán)寫入多個值,設現(xiàn)有一程序,要將最近使用的幾個文件名保存下來,具體程序如下:
1.寫入:
CString strTemp,strTempA;
int i;
int nCount=6;
file://共有6個文件名需要保存
for(i=0;i {strTemp.Format("%d",i);
strTempA=文件名;
file://文件名可以從數(shù)組,列表框等處取得.
::WritePrivateProfileString("UseFileName","FileName"+strTemp,strTempA,
"c:""usefile""usefile.ini");
}
strTemp.Format("%d",nCount);
::WritePrivateProfileString("FileCount","Count",strTemp,
"c:""usefile""usefile.ini");
file://將文件總數(shù)寫入,以便讀出. 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中的內(nèi)容.
}
如果 ini 中沒有指定的 Section，API 會新建 Section，如果沒有指定的 Key 則新建一個 Key 并寫入數(shù)據(jù)，如果已經(jīng)存在，則用字符串代替原來的值。當指定的 ini 也不存在的時候，API 會自動建立一個新的文件，所以使用 ini 的好處是我們不必為了保存少量的數(shù)據(jù)涉及到文件操作，就連查找文件是否存在的操作都不必要。
使用要點：
??? 在我們實際使用的時候，用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString，但在對自定義 ini 文件操作的時候要注意的是，如果 lpFileName 指定的文件沒有路徑的話，Api 會去 Windows 的安裝目錄去找而不會在當前目錄找，但是每次用到 ini 函數(shù)要獲取當前路徑顯然太麻煩了，這里有一個變通的辦法，你只要在 ini 文件名前面加上 ./ 就可以了，比如說要對本目錄下的 user.ini 操作，那么文件名就是 './user.ini' 這樣顯然比較方便。另外，當你要把一個 Key 清除的時候，可以使用把 lpString 指向一個空的字符串然后使用 WritePrivateProfileString。當你要把一個 sectio的全部內(nèi)容清空的時候，也不必把 key 一個個的清除，可以使用把 lpString 指向一個空的字符串然后使用 WritePrivateProfileSection。
1.INI文件的路徑必須完整,文件名前面的各級目錄必須存在,否則寫入不成功,該函數(shù)返回 FALSE 值.
2.文件名的路徑中必須為 "" ,因為在VC++中, "" 才表示一個 " .
3.也可將INI文件放在程序所在目錄,此時 lpFileName 參數(shù)為: “.""student.ini”.
轉載于:https://www.cnblogs.com/zlshmily/p/9993184.html
總結
- 上一篇： 嵌入式学习路线怎么学，如何学习嵌入式系统
- 下一篇： 三、单一职责原则、开放-封闭原则、依赖倒