在程序中經常要用到設置或者其他少量數據的存盤，以便程序在下一次執行的時候可以使用，比如說保存本次程序執行時窗口的位置、大小、一些用戶設置的數據等等，在 Dos 下編程的時候，我們一般自己產生一個文件，由自己把這些數據寫到文件中，然后在下一次執行的時候再讀出來使用。在 Win32 編程中當然你也可以這樣干，但 Windows 已經為我們提供了兩種方便的辦法，那就是使用注冊表或者 ini 文件（Profile）來保存少量數據。本文中先介紹一下 .ini 文件的使用。?

ini 文件是文本文件，中間的數據格式一般為：?
[Section1 Name]?
KeyName1=value1?
KeyName2=value2?
...?

[Section2 Name]?
KeyName1=value1?
KeyName2=value2?

ini 文件可以分為幾個 Section，每個 Section 的名稱用 [] 括起來，在一個 Section 中，可以有很多的 Key，每一個 Key 可以有一個值并占用一行，格式是 Key=value，Win32 對 ini 文件操作的 api 中，有一部分是對 win.ini 操作的，有一部分是對用戶自定義的 ini 文件操作的。Win.in 和 system.ini 是Windows的兩個非常重要的初始化文件，Windows將用戶所作的選擇以及各種變化的系統信息記錄在這兩個文件中。System.ini 描述了系統硬件的當前狀態，Win.ini 文件則包含了Windows 系統運行環境的當前配置。由于 Win.ini 文件的重要性和常用性，Win32 中有專門對 Win.ini 進行操作的 api，它們是：?

GetProfileInt - 從 Win.ini 文件的某個 Section 取得一個 key 的整數值，它的原形是：?

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

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


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 讀出后再處理。?


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 文件的操作的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。