INI文件的操作

文章來自：http://www.cppblog.com/yishanhante/articles/19546.html、

 

在程序中經常要用到設置或者其他少量數據的存盤，以便程序在下一次執行的時候可以使用，比如說保存本次程序執行時窗口的位置、大小、一些用戶設置的數據等等，在 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。