C++判斷QMetaObject::invokeMethod()里的函數(shù)是否調用成功
今天，在Qt編程，碰到一個需要使用invokeMethod方式來獲取函數(shù)是否執(zhí)行成功的情況。
invokeMethod()即可以同步調用，也可以異步調用。若調用者、被調用者，都在同一個線程，則是同步調用；若調用者、被調用者，在不同線程，則是異步調用。
注意：只有同步調用，才能通過invokeMethod()的返回值，來判斷函數(shù)是否執(zhí)行成功。
比如，有如下精簡代碼:
//1）業(yè)務代碼
class ComWork : public QObject {
Q_OBJECT
public:
ComWork();
signals:
void sigSendResult(bool bOK);
public slots:
void SendCommand(QByteArray by) {
qint64 nRet = m_pSerial->write(by);
bool bOK = (nRet != -1);
if(bOK)
m_pSerial->flush();
emit sigSendResult(bOK);
}
private:
QSerialPort* m_pSerial;
};
//2） 界面邏輯代碼
class ZoomWidget : public QWidget {
public:
ZoomWidget (QWidget *parent= NULL);
protected slots:
void OnRecvCmdResult(bool bOK);
private:
QThread* m_pThread; //子線程
ComWork* m_pWork;
bool m_bResult;
};
ZoomWidget ::ZoomWidget (QWidget *parent)
: QWidget(parent)
{
ui.setupUi(this);
m_pThread = new QThread(this);
m_pWork = new ComWork();
m_pWork->moveToThread(m_pThread); //m_pWork移動到子線程里，語句(a)
//連接信號,語句(b)
connect(m_pWork,&m_pWork::sigSendResult,this,ZoomWidget::OnRecvCmdResult);
}
ZoomWidget::OnRecvCmdResult(bool bOK)
{
m_bResult = bOK; //語句(c)
qDebug()<<"recv status:"<<bOK;
}
// 3）核心調用
ZoomWidget::DoSend()
{
//進行調用,語句(d)
QMetaObject::invokeMethod(m_pWork, "SendCommand", Qt::QueuedConnection, Q_ARG(QByteArray, sendData));
}
在Qt中，UI對象必須在主線程。而ZoomWidget是一個QWidtget，屬于UI對象，即ZoomWidget在主線程。
由語句(a)可知，m_pWork移動到了子線程里，即ZoomWidget與m_pWork不在同一個線程，
則在調用DoSend()函數(shù)時，QMetaObject::invokeMethod(m_pWork,…）其實是跨線程調用，也就是異步調用。而異步調用，由于"它不會等待函數(shù)是否執(zhí)行，就直接返回了"，即invokeMethod(,…Qt::QueuedConnection ,)函數(shù)，不會等待m_pWork的SendCommand()是否執(zhí)行，就直接返回，并給出一個返回值，該返回值是無效的。
如果強制返回，Qt編譯也會報"QMetaMethod::invoke: Unable to invoke methods with return values in queued connections"錯誤。
但可以通過信號槽的方式，把異步調用的結果(比如語句(b)、語句©)，返回給調用者(比如本例的ZoomWidget)。
這個 "Unable to invoke methods"的Qt 編譯報錯：
QMetaMethod::invoke: Unable to invoke methods with return values in queued connections
是一個非常常見的運行時錯誤，它的含義是：
你試圖使用 Qt::QueuedConnection（即異步方式）調用一個帶有返回值的方法，而這是 Qt 不支持的。
錯誤原因詳解
什么是Qt::QueuedConnection？
- 它表示方法調用會在目標對象所在的線程中排隊執(zhí)行（異步調用），而不是立即執(zhí)行。
- 常用于跨線程通信，比如從子線程調用主線程的 UI 方法。
為什么不能在Qt::QueuedConnection中使用帶返回值的函數(shù)？
- 因為它是異步調用，調用者不會等待函數(shù)執(zhí)行完成。
- 所以無法通過
Q_RETURN_ARG(...)拿到函數(shù)的返回值。 - Qt 在底層會檢測這一點，并拋出警告或導致返回值無效。
示例代碼：錯誤寫法
int result = 0;
bool success = QMetaObject::invokeMethod(obj, "addNumbers",
Qt::QueuedConnection, // ? 異步調用
Q_RETURN_ARG(int, result),
Q_ARG(int, 3),
Q_ARG(int, 5));
上面這段代碼會導致報錯：
QMetaMethod::invoke: Unable to invoke methods with return values in queued connections
正確做法
? 方法一：使用Qt::DirectConnection（同步調用）
如果你需要獲取返回值，請使用同步連接方式：
int result = 0;
bool success = QMetaObject::invokeMethod(obj, "addNumbers",
Qt::DirectConnection, // ? 同步調用
Q_RETURN_ARG(int, result),
Q_ARG(int, 3),
Q_ARG(int, 5));
if (success) {
qDebug() << "Result:" << result;
}
?? 注意：Qt::DirectConnection 要求調用線程和目標對象處于同一個線程，否則行為未定義。
? 方法二：避免返回值 + 使用信號傳遞結果（適合異步場景）
如果你確實需要跨線程調用并想獲取結果，可以這樣做：
步驟如下：
- 將原函數(shù)改為無返回值；
- 使用 QMetaObject::invokeMethod() 調用它；
- 函數(shù)內部處理完后，發(fā)出一個信號把結果傳回來。
示例代碼：
class Worker : public QObject {
Q_OBJECT
signals:
void resultReady(int result); // 用于返回結果
public slots:
void addNumbersAsync(int a, int b) {
int result = a + b;
emit resultReady(result); // 發(fā)送結果
}
};
調用方式：
Worker* worker = new Worker();
worker->moveToThread(thread);
// 連接信號與槽來接收結果
connect(worker, &Worker::resultReady, this, [](int res) {
qDebug() << "異步返回結果：" << res;
});
// 異步調用
QMetaObject::invokeMethod(worker, "addNumbersAsync",
Qt::QueuedConnection,
Q_ARG(int, 3),
Q_ARG(int, 5));
總結1
| 場景 | 是否允許返回值 | 推薦連接方式 | 備注 |
|---|---|---|---|
| 同一線程調用，需返回值 | ? 是 | Qt::DirectConnection | 可使用 Q_RETURN_ARG |
| 跨線程調用，需返回值 | ? 否 | ? 不可用 | 必須用信號傳遞結果 |
| 跨線程調用，不需要返回值 | ? 是 | Qt::QueuedConnection | 正常使用 |
QMetaObject::invokeMethod()的返回值類型
bool QMetaObject::invokeMethod(QObject *obj, const char *member, Qt::ConnectionType type, QGenericReturnArgument ret, ...)
返回值說明：
- 返回類型：bool
- 返回值含義：
- true：表示方法成功調用。
- false：表示方法調用失敗，可能原因包括：
- 沒有找到名字匹配的方法（函數(shù)名錯誤或未聲明為 Q_INVOKABLE 或 slot）。
- 參數(shù)類型不匹配。
- 對象已經被刪除（懸空指針）。
- 使用了 Qt::QueuedConnection 但目標對象沒有運行事件循環(huán)。
如何進一步排查失敗原因？
雖然返回值只能告訴你是否成功，但你可以通過以下方式定位問題：
1. 檢查函數(shù)是否被正確聲明為Q_INVOKABLE或slot
class Worker : public QObject {
Q_OBJECT
public slots:
void OpenPort(const QString &portName, int baudRate); // 必須匹配參數(shù)類型
};
或者：
Q_INVOKABLE void OpenPort(const QString &portName, int baudRate);
2. 確保對象沒有被釋放（避免懸空指針）
確保 m_pWork 是一個有效的 QObject* 指針，且對象尚未被 delete。
3. 參數(shù)類型必須一致（支持元對象系統(tǒng)）
確保你使用的參數(shù)類型是 Qt 元對象系統(tǒng)支持的類型（如 int, QString, double 等），或者自定義類型已注冊：
Q_DECLARE_METATYPE(MyCustomType) qRegisterMetaType<MyCustomType>();
4. 調試輸出所有可用方法（用于排查函數(shù)名/參數(shù)是否正確）
const QMetaObject* metaObj = m_pWork->metaObject();
for (int i = 0; i < metaObj->methodCount(); ++i) {
qDebug() << metaObj->method(i).signature();
}
總結2
| 內容 | 說明 |
|---|---|
| invokeMethod() 是否有返回值？ | ? 有，返回 bool 類型 |
| true 表示什么？ | 方法調用成功 |
| false 表示什么？ | 方法調用失敗（函數(shù)名錯誤、參數(shù)不匹配、對象無效、異步調用等） |
| 可以用來做什么？ | 判斷函數(shù)是否被成功調用，用于調試和錯誤處理 |
到此這篇關于判斷QMetaObject::invokeMethod()里的函數(shù)是否調用成功的文章就介紹到這了,更多相關QMetaObject::invokeMethod()調用內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要介紹了C語言實現(xiàn)Fibonacci數(shù)列遞歸，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-02-02
C語言中的sizeof和strlen是兩個常用的操作符/函數(shù),但它們的功能和用途有很大的區(qū)別，本文就詳細的來介紹一下C語言sizeof和strlen區(qū)別，具有一定的參考價值，感興趣的可以了解一下2024-01-01
這篇文章主要介紹了C++變量存儲的生命周期與作用域，從創(chuàng)建到消亡的完整過程,例如人從出生到死亡的整個過程就是一個生命周期。本文將通過示例為大家詳細講講，感興趣的可以學習一下2022-10-10
這篇文章主要介紹了C語言在頭文件中定義const變量詳解的相關資料,需要的朋友可以參考下2017-05-05
這篇文章主要為大家分享了C語言圖書借閱系統(tǒng)源碼，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-02-02
這篇文章主要介紹了VC++ 自定義控件的建立及使用方法的相關資料，十分的詳細,需要的朋友可以參考下2015-06-06
斷言是C語言中一種用于檢查程序中假設語句正確性的方法,通過使用斷言,開發(fā)人員可以在程序中插入一些條件,以確保程序的執(zhí)行滿足特定的預期,這篇文章主要給大家介紹了關于c語言中assert斷言用法的相關資料,需要的朋友可以參考下2024-02-02
Qt的Qss是一種用于定義用戶界面的樣式表語言，本文主要介紹了Qt的Qss用法小結，非常具有實用價值，需要的朋友可以參考下2023-06-06
VC++?2019?"const?char*"類型的實參與"LPCTSTR"
這篇文章主要給大家介紹了關于VC++?2019?"const?char*"類型的實參與"LPCTSTR"類型的形參不兼容的解決方法,文中通過圖文介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2023-03-03
這篇文章主要介紹了c++輸出斐波那契數(shù)列示例,需要的朋友可以參考下2014-03-03