簡述

一般情況下，我們在開發軟體過程中，都會快取一些資訊到本地，可以使用輕量級資料庫sqlite，也可以操作登錄檔、讀寫配置檔案。

關於QSettings的使用前面已經介紹過了，比較詳細，見“更多參考”，下面介紹下QSettings常用功能-讀寫登錄檔、配置檔案。

• 簡述
• 優點
• 讀寫配置檔案
  • 一般儲存
  • 一般讀取
  • 分組儲存
  • 分組讀取
  • 分目錄儲存
• 刪除內容
• 疑問解釋
• 更多參考

優點

無需指定登錄檔路徑

一般情況下，我們需要定義一個巨集，或者常量字串來指定儲存的登錄檔位置。

• #define HKEY_CURRENT_USER_QT "HKEY_CURRENT_USER\\SoftWare\\Digia\\Qt"
• const QString HKEY_CURRENT_USER_QT = "HKEY_CURRENT_USER\\SoftWare\\Digia\\Qt";

無需指定配置檔案路徑

一般情況下，我們需要定義一個巨集，或者常量字串來指定儲存的配置檔案位置及名稱。

• #define INI_QT "C:\Users\WangLiang\AppData\Roaming\Digia"
• const QString INI_QT = "C:\Users\WangLiang\AppData\Roaming\Digia";

採用下面方式，我們不需要做太多工作，Qt已經很好的替你實現了！

讀寫登錄檔

一般儲存

下面我們以Qt為例，眾所周知現在Qt已經屬於Digia，也就是說：組織名為Digia，產品名為Qt。

在main()函式中，首先設定組織名、產品名。

QCoreApplication::setOrganizationName(QString("Digia"));
QCoreApplication::setApplicationName(QString("Qt"));

然後使用QSettings對登錄檔進行操作：

QSettings settings(QSettings::NativeFormat, QSettings::UserScope, QCoreApplication::organizationName
 
(), QCoreApplication::applicationName());

settings.setValue("Name", "Qt Creator");
settings.setValue("Version", 5);

這時，我們開啟登錄檔regedit，資料就生成了。

一般讀取

儲存完資料之後，預設的程式啟動時需要載入對應的資料。

QString strName = settings.value("Name").toString();
int nVersion = settings.value("Version").toInt();
//Name:Qt Creator  Version:5

這時，我們可以通過檢視應用程式輸出視窗得到輸出結果。

分目錄儲存

如果我們需要在同一路徑下建立多個子目錄該怎麼辦，下面介紹兩種方式。

替換applicationName

如上，我們可以看出，organizationName對應的登錄檔路徑為HKEY_CURRENT_USER\\SoftWare\\Digia，applicationName對應的為其下一級的目錄，那麼分目錄就需要更改其對應的applicationName。

QSettings settings(QSettings::NativeFormat, QSettings::UserScope, QString("%1\\%2").arg(QCoreApplication::organizationName()).arg(QCoreApplication::applicationName()), "Qt5.5");

settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.5");

QSettings settings2(QString("%1\\%2").arg(QCoreApplication::organizationName()).arg(QCoreApplication::applicationName()), "Qt5.6");

settings2.setValue("Name", "Qt Creator");
settings2.setValue("Version", "5.6");

分組

替換applicationName的方式看起來有些繁瑣，相比之下，使用group分組則會更簡單！

QSettings settings;
settings.beginGroup("Qt5.5");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.5");
settings.endGroup();

settings.beginGroup("Qt5.6");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.6");
settings.endGroup();

這時，我們再次檢視登錄檔資料。

注：
新建目錄，則需要重新開啟登錄檔，如果新新增設定，則不需要重新開啟登錄檔，只需要來回切換對應的選項即可。

讀寫配置檔案

一般儲存

如上，我們只需要將格式從NativeFormat變為IniFormat即可：

QSettings settings(QSettings::IniFormat, QSettings::UserScope, QCoreApplication::organizationName(), QCoreApplication::applicationName());

settings.setValue("Name", "Qt Creator");
settings.setValue("Version", 5);

這時，我們開啟對應的儲存目錄，資料就生成了。

我們可以進入資料夾：C:\Users\WangLiang\AppData\Roaming（AppData預設為隱藏檔案，需要設定顯示才可檢視），可以看到生成了資料夾”Digia”以及配置檔案”Qt.ini”。

一般讀取

儲存完資料之後，預設的程式啟動時需要載入對應的資料。

QString strName = settings.value("Name").toString();
int nVersion = settings.value("Version").toInt();
//Name:Qt Creator  Version:5

這時，我們可以通過檢視應用程式輸出視窗得到輸出結果。

分組儲存

我們可以看到配置檔案中包含預設的分組為：General。通常情況下，我們需要對配置進行歸類，例如：使用者名稱、密碼等資訊屬於使用者組，產品名稱、版本號屬於設定組。

QSettings settings(QSettings::IniFormat, QSettings::UserScope, QCoreApplication::organizationName(), QCoreApplication::applicationName());

settings.beginGroup("Setting");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", 5);
settings.endGroup();

settings.beginGroup("User");
settings.setValue("UserName", "WangL");
settings.setValue("Password", "123456");
settings.endGroup();

這時我們再次檢視配置檔案，裡面已經生成了另外兩個分組。

分組讀取

settings.beginGroup("Setting");
QString strName = settings.value("Name").toString();
int nVersion = settings.value("Version").toInt();
settings.endGroup();
//Name:Qt Creator  Version:5

settings.beginGroup("User");
QString strUserName = settings.value("UserName").toString();
QString strPassword = settings.value("Password").toString();
settings.endGroup();
//UserName:WangL  Password:123456

分目錄儲存

什麼時候需要分目錄儲存呢？QQ大家都用過吧，是不是每一個使用者都有一個對應QQ號的目錄呢，裡面儲存各個使用者對應的資訊。

如上，我們可以看出，organizationName對應的本地路徑為C:\Users\WangLiang\AppData\Roaming\Digia，applicationName對應的為其下的配置檔案，那麼如果我們需要在同一路徑下建立多個目錄就需要更改對應的organizationName，配置檔名稱則需要更改其對應的applicationName了。

QSettings settings(QSettings::IniFormat, QSettings::UserScope, QString("%1\\%2\\%3").arg(QCoreApplication::organizationName()).arg(QCoreApplication::applicationName()).arg("Qt5.5"), "User");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.5");

QSettings settings2(QSettings::IniFormat, QSettings::UserScope, QString("%1\\%2\\%3").arg(QCoreApplication::organizationName()).arg(QCoreApplication::applicationName()).arg("Qt5.5"), "User");
settings2.setValue("Name", "Qt Creator");
settings2.setValue("Version", "5.6");

這時，我們再次檢視本地檔案，則會發現C:\Users\WangLiang\AppData\Roaming\Digia\Qt所在目錄下會生成兩個資料夾”Qt5.5”和”Qt5.6”，並且每一個目錄底下會生成對應的配置檔案User.ini。

刪除內容

刪除一個指定的鍵

QSettings settings;
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", 5);

settings.remove("Name");

QStringList keys = settings.allKeys();
// keys: ["Version"]

清空所有鍵

settings.clear(); 
QStringList keys = settings.allKeys();
// keys: []

刪除設定鍵以及子設定鍵

QSettings settings;
settings.setValue("Qt5.6", "5.6");

settings.beginGroup("Qt5.5");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.5");
settings.endGroup();

settings.beginGroup("Qt5.6");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.6");
settings.endGroup();

settings.remove("Qt5.6");

QStringList strList = settings.allKeys();
// keys: ["Qt5.5/Name", "Qt5.5/Version"]

如果key為空字串，在當前group()的所有鍵將被刪除。

QSettings settings;
settings.setValue("Qt5.6", "5.6");

settings.beginGroup("Qt5.5");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.5");
settings.endGroup();

settings.beginGroup("Qt5.6");
settings.setValue("Name", "Qt Creator");
settings.setValue("Version", "5.6");
settings.endGroup();

settings.beginGroup("Qt5.6");
settings.remove("");
settings.endGroup();

QStringList keys = settings.allKeys();
// keys: ["Qt5.5/Name", "Qt5.5/Version"]

疑問解釋

如上文程式碼，我們可以知道未刪除之前keys: ["Qt5.6", "Qt5.5/Name", "Qt5.5/Version", "Qt5.6/Name", "Qt5.6/Version"]，其中Qt5.6所在分組為預設的General。

那麼呼叫下面程式碼：

settings.beginGroup("Qt5.6");
settings.remove("");
settings.endGroup();

應該只刪除對應組中的所有鍵才對，也就是說剩餘的keys應該為 ["Qt5.6", "Qt5.5/Name", "Qt5.5/Version"]，General下的鍵為什麼會被刪除呢？好，這裡先跳過，繼續。

General下的鍵既然可以被刪除，那麼在Qt5.5分組下建立對應的Qt5.6鍵值，應該也會被刪除。

刪除前：

刪除後：

什麼鬼，為嘛Qt5.5分組下的Qt5.6對應的鍵還在呢？

我們繼續分析：

刪除前：keys: ["Qt5.6", "Qt5.5/Qt5.6", "Qt5.5/Name", "Qt5.5/Version", "Qt5.6/Name", "Qt5.6/Version"]。

助手中關於remove()的說明為：Removes the setting key and any sub-settings of key.

也就是說：Qt5.5/Qt5.6鍵中即使存在Qt5.6，但是所屬的setting key為Qt5.5而非Qt5.6，所以不會被刪掉。

既然這樣，那麼我們的疑問也就不復存在了。

更多參考