我們要存檔,儲存的到底是什麼呢?物件 (object) 嗎?資料成員 (data member) 嗎?還有成員函數 (member function) 呢?
↘
成員函數
如果某次編碼結果不錯,我們往後想要繼續利用同一個 Encrypt 物件,這時候就需要把 Encrypt 物件儲存下來。想一想我們存檔應該儲存什麼?把整個 Encrypt 物件都儲存下來,還是只要儲存編碼用的 code_array 就可以了呢?
問題很簡單,就是存檔究竟要儲存什麼,儲存整個 Encrypt 物件也不是不行,不過這樣存檔載入都變得有點複雜,物件還得序列化 (serialization) 等等。想一想,如果情況改成遊戲程式的話,儲存的不外是遊戲狀態或進度的資料表,資料表中大概都是數字或字串 (string) ,因此實際儲存的也會是數字跟字串。
如果是要儲存數字或字串,解決問題的方式就更簡單了,因為數字或字串都是很常用的資料格式,程式庫針對很常用的資料格式都有直接套用的方式,因此我們可以直接儲存密碼表字串就可以了。
我們對 on_pushButton_save_clicked() 的實作如下
// 按下「儲存」按鈕的事件
void EncryptWindow::on_pushButton_save_clicked()
{
// 先測試是否有按過「新建」按鈕
if (e != nullptr) {
// 有按過「新建」按鈕,建立檔名 encryptor 的 QFile 物件
QFile file("encryptor");
// 以寫入模式開啟檔案
file.open(QIODevice::WriteOnly);
// 建立 QDataStream 物件讀取檔案串流
QDataStream out(&file);
// 從 QDataStream 物件將密碼表輸出到檔案
out << s2q(e->get_code_array());
// 最後在 label_display 顯示提示訊息
ui->label_display->setText("已儲存。");
}
else {
// 沒按過「新建」按鈕,在 label_display 顯示提示訊息
ui->label_display->setText("無編碼物件,無法儲存。");
}
}
完整程式請參考 encryptwindow.cpp 。
這裡同樣做了個預防措施,如果 e 為 nullptr ,就是使用者沒有按過 新建 按鈕,因此沒有密碼表可以儲存,所以直接在 label_display 顯示提示訊息。
實際存檔是建立 QFile 型態 (type) 的物件 file ,並以檔名字串當建構函數 (constructor) 的參數 (parameter) ,接著設定開啟方式為寫入,也就是 QIODevice::WriteOnly
// 有按過「新建」按鈕,建立檔名 encryptor 的 QFile 物件
QFile file("encryptor");
// 以寫入模式開啟檔案
file.open(QIODevice::WriteOnly);
接著用 QDataStream 型態的物件 out 進行寫入,需要以 QFile 物件的指標當參數,最後用輸出運算子將密碼表寫到 out 內,也就是存到檔案 encryptor 中
// 建立 QDataStream 物件讀取檔案串流
QDataStream out(&file);
// 從 QDataStream 物件將密碼表輸出到檔案
out << s2q(e->get_code_array());
這裡的變數 out 跟標準程式庫 iostream 中的 out 有一樣的名稱,兩者都表示輸出,前者輸出到檔案,後者則是輸出到標準輸出裝置。
Mac 系統裡 encryptor 檔案可能會儲存在編譯好的 encrypt_gui 執行檔套件內。
這樣就完成存檔了,倒是用了 QFile 與 QDataStream ,就要先 #include 進來
#include <QFile>
#include <QDataStream>
下面我們繼續看到載入 on_pushButton_load_clicked() 的實作
// 按下「載入」按鈕的事件
void EncryptWindow::on_pushButton_load_clicked()
{
// 建立檔名 encryptor 的 QFile 物件
QFile file("encryptor");
// 以唯讀模式開啟,先測試檔案存不存在
if (file.open(QIODevice::ReadOnly)) {
// 檔案存在,建立 QDataStream 物件讀取檔案串流
QDataStream in(&file);
// 建立一個 QString 字串暫存密碼表
QString temp;
// 從 QDataStream 物件將密碼表輸出到 QString 字串
in >> temp;
// 如果使用者沒按過「新建」,先新建成員變數 e
if (e == nullptr) {
e = new Encrypt;
}
// 將密碼表寫入成員變數 e
e->set_code_array(q2s(temp));
// 最後在 label_display 顯示提示訊息
ui->label_display->setText(""編碼物件已載入。"");
}
else {
// 檔案不存在,在 label_display 顯示提示訊息
ui->label_display->setText("編碼物件無法載入。");
}
}
跟存檔比較不一樣的是這裡先建立 QFile 檔案物件 file ,然後用唯獨模式 QIODevice::ReadOnly 開啟, open() 會傳布林值,若存在檔案就是 true
// 建立檔名 encryptor 的 QFile 物件
QFile file("encryptor");
// 以唯讀模式開啟,先測試檔案存不存在
if (file.open(QIODevice::ReadOnly)) {
在其他程式語言中,有關檔案的部份可能要放到例外處理 (exception handling) 之中, C++ 也有例外處理的機制,倒是沒有強制限制要用例外處理檔案,因此直接測試檔案是否存在,如此可減少額外的處理時間。
接下來由 QDataStream 型態的 in 寫入資料到 QString 的 temp 中
// 檔案存在,建立 QDataStream 物件讀取檔案串流
QDataStream in(&file);
// 建立一個 QString 字串暫存密碼表
QString temp;
// 從 QDataStream 物件將密碼表輸出到 QString 字串
in >> temp;
後續測試 e 是不是 nullptr ,如果是 nullptr 就新建 Encrypt ,不然可能會發生不能寫入的問題,最後就直接用 e 設定密碼表。
// 如果使用者沒按過「新建」,先新建成員變數 e
if (e == nullptr) {
e = new Encrypt;
}
// 將密碼表寫入成員變數 e
e->set_code_array(q2s(temp));
咦?有參數版本的 set_code_array() 並無實作,留待練習來實作好了,下個單元我們繼續完成其他功能囉!
相關教學影片
中英文術語對照 | |
---|---|
物件 | object |
資料成員 | data member |
成員函數 | member function |
序列化 | serialization |
字串 | string |
型態 | type |
建構函數 | constructor |
參數 | parameter |
例外處理 | exception handling |
重點整理 |
---|
1. 存檔機制採用儲存密碼表的方式,利用 QFile 及 QDataStream 將密碼表寫進 encryptor 中。 |
2. 載入同樣利用 QFile 及 QDataStream ,將密碼表讀取到暫存的 QString 字串,然後再寫入密碼表。 |
問題與討論 |
---|
1. 比較儲存物件及儲存字串的優劣,列出兩者的優缺點。 |
2. 什麼是例外處理?什麼情況下要做例外處理? |
練習 |
---|
1. 實作 set_code_array(string) ,除了要在實作檔實作外,也要在標頭檔加入宣告。 |
2. 承接上一個單元的 guess_game 專案,想一想要不要有存檔的機制。 |