VC中操做INI文件的函數

今天需瞭解vc中如何讀取ini文件,發現一兄臺博文中介紹的如此詳細,所以轉帖到此,以備後用......api

VC中操做INI文件的函數主要有:數組


函數名 功能
GetPrivateProfileInt                       讀取INI文件指定塊中的鍵名對應的整數值。
GetPrivateProfileSection 記取INI文件指定塊中的全部鍵名及其對應值。
GetPrivateProfileSectionNames 讀取一INI文件中全部的塊名。
GetPrivateProfileString 讀取INI文件指定塊中的鍵名對應的字符串。
GetPrivateProfileStruct 讀取INI文件指定塊中的鍵名對應的數據
GetProfileInt 讀取win.ini中指定塊中的鍵名對應的整數值。
GetProfileSection 讀取win.ini中指定塊中全部的鍵名及其值。
GetProfileString

讀取win.ini中指定塊中的鍵名的對應值。緩存


WritePrivateProfileSection 替換INI文件中指定塊中全部鍵名對應的值。
WritePrivateProfileString 把給定的鍵名及其值寫入到指定INI文件的相應塊中。
WritePrivateProfileStruct 把指定的鍵名及其數據寫入到指定INI文件的塊中。
WriteProfileSection 替換win.ini中指定塊的全部鍵名對應的值。
WriteProfileString 將給定的鍵名及值寫入win.ini中對應的塊中。




INI文件可用來保存,共享應用程序中少許的數據,其格式通常爲:ide

[塊名1]
鍵名=值
...
[塊名n]
鍵名=值函數

通常一個INI文件可有N個塊,第塊可有n個鍵名及值對應。每一個鍵名及其值佔一行。
通常鍵的名稱可任取,不過建議用有意義的字符及詞構成。值通常可爲整數和字符串,其它類型要進行轉換。spa

GetProfileInt - 從 Win.ini 文件的某個 Section 取得一個 key 的整數值,它的原形是:orm

GetProfileInt(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
INT nDefault // 若是 Key 值沒有找到,則返回缺省的值是多少
);對象

若是 Key 值沒有找到的話,返回值是 nDefault 指定的缺省值,若是 Key 中的值是負數,則返回 0,若是 Key 指定的是數字和字符串的混合,則返回數字部分的值,好比說 x=1234abcd,則返回 1234ci


GetProfileString - 從 Win.ini 文件的某個 Section 取得一個 key 的字符串,它的原形是:字符串

GetProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpDefault, // 若是 Key 值沒有找到,則返回缺省的字符串的地址
LPTSTR lpReturnedString, // 返回字符串的緩衝區地址
DWORD nSize // 緩衝區的長度
);

返回的字符串在緩衝區內,返回的 eax 值是返回的字符串的長度(不包括尾部的0)


GetProfileSection - 從 Win.ini 文件中讀出整個 Section 的內容,它的原形是:

GetProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPTSTR lpReturnedString, // 返回數據的緩衝區地址
DWORD nSize // 返回數據的緩衝區長度
);


WriteProfileSection - 將一個整個 Section 的值 寫入 Win.ini 文件的指定 Section 中,它的原形是:

WriteProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpString // 要寫入的數據的地址
);

若是 Win.ini 沒有指定的 Section,API 會新創建一個並寫入數據,若是已經存在,則先刪除原來 Seciton 中全部的 Key 值而後寫入新的。


WriteProfileString - 將一個 Key 值寫入 Win.ini 文件的指定 Section 中,它的原形是:

WriteProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpString // 要寫的字符串地址
);

若是 Win.ini 沒有指定的 Section,API 會新建 Section,若是沒有指定的 Key 則新建一個 Key 並寫入數據,若是已經存在,則用字符串代替原來的值。
以上的 Api 是對 Win.ini 操做的,固然對於咱們來講,用的更多的是在程序運行的目錄中創建本身的 ini 文件,若是須要對本身的 ini 文件操做,就要用到另外一組 Api,這一組 api 和上面的很象,只要把上面一組的 Profile 換成 PrivateProfile(私有的)就能夠了,參數中也相應的多了一個 ini 文件名的參數。例如 GetPrivateProfileInt、GetPrivateProfileSection、WritePrivateProfileString 等等, 下面分別介紹:

GetPrivateProfileInt - 從 ini 文件的某個 Section 取得一個 key 的整數值,它的原形是:

GetPrivateProfileInt(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
INT nDefault // 若是 Key 值沒有找到,則返回缺省的值是多少
LPCTSTR lpFileName // ini 文件的文件名
);

中間參數和返回值的定義和 GetProfileInt 是同樣的。


GetPrivateProfileString - 從 ini 文件的某個 Section 取得一個 key 的字符串,它的原形是:

GetPrivateProfileString(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpKeyName, // 指向包含 Key 名稱的字符串地址
LPCTSTR lpDefault, // 若是 Key 值沒有找到,則返回缺省的字符串的地址
LPTSTR lpReturnedString, // 返回字符串的緩衝區地址
DWORD nSize // 緩衝區的長度
LPCTSTR lpFileName // ini 文件的文件名
);


GetPrivateProfileSection - 從 ini 文件中讀出整個 Section 的內容,它的原形是:

GetPrivateProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPTSTR lpReturnedString, // 返回數據的緩衝區地址
DWORD nSize // 返回數據的緩衝區長度
LPCTSTR lpFileName // ini 文件的文件名
);

這個 api 能夠讀出整個 section 的內容,當你不知道 section 中有哪些 key 的時候,可使用這個 api 將整個 section 讀出後再處理。

說明:

例ini文件爲:

[student]

Name=tian

Age=20

Sex=man

GetPrivateProfileSection()函數第二個參數lpReturnedString 返回的字符串以下:

Name=tian"0Age=20"0Sex=man"0"0(每條以"0分割,最後以兩個"0結束)

而咱們是想等到每一個key及其對應的值,那怎麼分割上面那個字符串呢?在VB有中個叫Split()函數,用起來很方便,可是vc裏面沒有。

固然,你也能夠在VC中去實現一個Split()函數,不過我在這裏提供一個簡單的方法:

CString strKey;

        while(*str!='"0') //str爲lpReturnedString返回的字符串

        {      

                  strKey = str;

                  MessageBox(strKey); //strKey爲每一個key及其對應的值

                  str += strKey.GetLength()+1;

        }


GetPrivateProfileSectionNames - 從 ini 文件中得到 Section 的名稱,它的原形是:

GetPrivateProfileSectionNames(
LPTSTR lpszReturnBuffer, // 返回數據的緩衝區地址
DWORD nSize // 返回數據的緩衝區長度
LPCTSTR lpFileName // ini 文件的文件名
);

若是 ini 中有兩個 Section: [sec1] 和 [sec2],則返回的是 'sec1',0,'sec2',0,0 ,當你不知道 ini 中有哪些 section 的時候能夠用這個 api 來獲取名稱


WritePrivateProfileSection - 將一個整個 Section 的內容入 ini 文件的指定 Section 中,它的原形是:

WritePrivateProfileSection(
LPCTSTR lpAppName, // 指向包含 Section 名稱的字符串地址
LPCTSTR lpString // 要寫入的數據的地址
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 並寫入數據,若是已經存在,則用字符串代替原來的值。當指定的 ini 也不存在的時候,API 會自動創建一個新的文件,因此使用 ini 的好處是咱們沒必要爲了保存少許的數據涉及到文件操做,就連查找文件是否存在的操做都沒必要要。

使用要點:

在咱們實際使用的時候,用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString,但在對自定義 ini 文件操做的時候要注意的是,若是 lpFileName 指定的文件沒有路徑的話,Api 會去 Windows 的安裝目錄去找而不會在當前目錄找,可是每次用到 ini 函數要獲取當前路徑顯然太麻煩了,這裏有一個變通的辦法,你只要在 ini 文件名前面加上 ." 就能夠了,好比說要對本目錄下的 user.ini 操做,那麼文件名就是 '."user.ini' 這樣顯然比較方便。另外,當你要把一個 Key 清除的時候,可使用把 lpString 指向一個空的字符串而後使用 WritePrivateProfileString。當你要把一個 section 的所有內容清空的時候,也沒必要把 key 一個個的清除,可使用把 lpString 指向一個空的字符串而後使用 WritePrivateProfileSection。


--------------------------------

在咱們寫的程序當中,總有一些配置信息須要保存下來,以便完成程序的功能,最簡單的辦法就是將這些信息寫入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中的內容.
}  
若是 ini 中沒有指定的 Section,API 會新建 Section,若是沒有指定的 Key 則新建一個 Key 並寫入數據,若是已經存在,則用字符串代替原來的值。當指定的 ini 也不存在的時候,API 會自動創建一個新的文件,因此使用 ini 的好處是咱們沒必要爲了保存少許的數據涉及到文件操做,就連查找文件是否存在的操做都沒必要要。
使用要點:
   在咱們實際使用的時候,用的最多的是 GetPrivateProfileString 和 WritePrivateProfileString,但在對自定義 ini 文件操做的時候要注意的是,若是 lpFileName 指定的文件沒有路徑的話,Api 會去 Windows 的安裝目錄去找而不會在當前目錄找,可是每次用到 ini 函數要獲取當前路徑顯然太麻煩了,這裏有一個變通的辦法,你只要在 ini 文件名前面加上 ./ 就能夠了,好比說要對本目錄下的 user.ini 操做,那麼文件名就是 './user.ini' 這樣顯然比較方便。另外,當你要把一個 Key 清除的時候,可使用把 lpString 指向一個空的字符串而後使用 WritePrivateProfileString。當你要把一個 sectio的所有內容清空的時候,也沒必要把 key 一個個的清除,可使用把 lpString 指向一個空的字符串而後使用 WritePrivateProfileSection。

1.INI文件的路徑必須完整,文件名前面的各級目錄必須存在,不然寫入不成功,該函數返回 FALSE 值.

2.文件名的路徑中必須爲 "" ,由於在VC++中, "" 才表示一個 " .

3.也可將INI文件放在程序所在目錄,此時 lpFileName 參數爲: 「.""student.ini」.


本文轉自:思若星辰 - CSDN博客

相關文章
相關標籤/搜索