C++ Qt開發：QHostInfo主機地址查詢元件

lyshark發表於2024-03-09
C++QT元件

Qt 是一個跨平臺C++圖形介面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以透過拖拽的方式將不同元件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹如何運用QHostInfo元件實現對主機地址查詢功能。

在Qt網路程式設計中，QHostInfo是一個強大而靈活的元件，用於獲取有關主機的資訊，包括主機名、IP地址和域名解析等。透過支援非同步查詢的機制，它能夠在後臺獲取主機資訊，避免阻塞主執行緒，同時透過訊號-槽機制提供查詢結果。其多主機查詢、可靠的錯誤處理和與網路環境的適應性，使其成為處理網路應用中主機資訊獲取的理想選擇。

以下是QHostInfo類的一些常用函式的解釋：

函式 描述
QHostInfo() 預設建構函式，建立一個空的QHostInfo物件。
QHostInfo(const QHostInfo &other) 複製建構函式，根據給定的other物件建立一個新的物件。
QHostInfo &operator=(const QHostInfo &other) 賦值運算子，將other物件的值賦給當前物件。
QHostInfo &swap(QHostInfo &other) 交換兩個QHostInfo物件的值。
bool isNull() const 判斷QHostInfo物件是否為空，即未進行任何查詢。
bool isComplete() const 判斷查詢是否完成，返回true表示查詢已完成，false表示正在進行中。
QList<QHostAddress> addresses() const 返回與主機相關聯的IP地址列表。
QString hostName() const 返回主機的名稱。
QStringList aliases() const 返回主機的別名列表。
QHostInfo::Error error() const 返回查詢時發生的錯誤。
QString errorString() const 返回與錯誤程式碼對應的人類可讀的錯誤字串。
static QHostInfo fromName(const QString &name) 根據主機名建立QHostInfo物件。
static QHostInfo fromAddress(const QHostAddress &address) 根據IP地址建立QHostInfo物件。
static QHostInfo localHostName() 返回本地主機的QHostInfo物件。
void clear() 清空QHostInfo物件，重置為初始狀態。
static void swap(QHostInfo &first, QHostInfo &second) 交換兩個QHostInfo物件的值。

這些函式提供了對主機資訊的查詢、獲取和處理的操作。需要注意，很多函式都是透過非同步查詢的方式獲取主機資訊的，因此在使用時需要透過訊號-槽機制來獲取查詢結果。

在使用這個模組時，要確保匯入QT+=network模組，接著來看該如何實現查詢本機IP地址，透過呼叫QHostInfo::localHostName可以直接獲取到本機的主機名，呼叫QHostInfo::fromName(hostName)可將該主機名轉換為對應的HostInfo結構，當具備了這個結構體以後，就可以透過迴圈遍歷addList.count()內的所有記錄，並aHost.toString()輸出所有的IP地址表，程式碼如下所示；

// 查詢本機IP地址
void MainWindow::on_pushButton_clicked()
{
    // 本地主機名
    QString hostName=QHostInfo::localHostName();
    std::cout << hostName.toStdString() << std::endl;
    ui->lineEdit->setText(hostName);

    // 查詢主機IP地址資訊
    QHostInfo hostInfo=QHostInfo::fromName(hostName);

    QList<QHostAddress> addList=hostInfo.addresses();
    if (!addList.isEmpty())
    for (int i=0;i<addList.count();i++)
    {
        // 每一項是一個QHostAddress
        QHostAddress aHost=addList.at(i);

        // 判斷是否為IPV4
        if(QAbstractSocket::IPv4Protocol==aHost.protocol())
        {
            ui->listWidget->addItem("IPV4 | " + aHost.toString());
        }
        else
        {
            ui->listWidget->addItem("IPV6 | " + aHost.toString());
        }
    }
}

執行後讀者可透過點選查詢資料按鈕實現對本機IP地址的獲取，輸出效果如下圖所示；

QHostInfo元件既可以查詢自身IP地址資訊，也可以實現對特定域名的IP解析，透過使用QHostInfo::lookupHost則可以實現查詢特定主機的地址資訊，該函式需要傳入一個回撥，如下所示我們在回撥函式內查詢主機所有的IP地址並輸出，其實現原理與上述方法相同。

void MainWindow::lookedUpHostInfo(const QHostInfo &host)
{
    // 每一項是一個QHostAddress
    QList<QHostAddress> addList=host.addresses();
    if (!addList.isEmpty())
    for (int i=0;i<addList.count();i++)
    {
        QHostAddress aHost=addList.at(i);

        // 判斷是否為IPV4
        if(QAbstractSocket::IPv4Protocol==aHost.protocol())
        {
            ui->listWidget_2->addItem("IPV4 | " + aHost.toString());
        }
        else
        {
            ui->listWidget_2->addItem("IPV6 | " + aHost.toString());
        }
    }
}

在查詢時只需要透過lookupHost呼叫即可，如下程式碼所示；

void MainWindow::on_pushButton_2_clicked()
{
    // 主機名
    QString hostname=ui->lineEdit_2->text();
    QHostInfo::lookupHost(hostname,this,SLOT(lookedUpHostInfo(QHostInfo)));
}

執行後讀者可透過點選查詢資料按鈕實現對特定域名的IP地址獲取，輸出效果如下圖所示；

相關文章