QModbusReply Class
QModbusReply クラスには、QModbusClient の派生クラスで送信されたリクエストのデータが含まれています。詳細...
| ヘッダー: | #include <QModbusReply> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SerialBus) target_link_libraries(mytarget PRIVATE Qt6::SerialBus) |
| qmake: | QT += serialbus |
| 継承元: | QObject |
パブリック型
| enum | ReplyType { Raw, Common, Broadcast } |
パブリック関数
| QModbusReply(QModbusReply::ReplyType type, int serverAddress, QObject *parent = nullptr) | |
| QModbusDevice::Error | error() const |
| QString | errorString() const |
(since 6.0) QList<QModbusDevice::IntermediateError> | intermediateErrors() const |
| bool | isFinished() const |
| QModbusResponse | rawResult() const |
| QModbusDataUnit | result() const |
| int | serverAddress() const |
| QModbusReply::ReplyType | type() const |
シグナル
| void | errorOccurred(QModbusDevice::Error error) |
| void | finished() |
メンバ型のドキュメント
enum QModbusReply::ReplyType
この列挙型は、可能な応答タイプを表します。
| 定数 | 値 | 説明 |
|---|---|---|
QModbusReply::Raw | 0 | この応答は、生の Modbus 要求に由来します。詳細については、以下を参照してください。QModbusClient::sendRawRequest |
QModbusReply::Common | 1 | 応答は、通常の読み取り、書き込み、または読み取り/書き込みリクエストに由来します。QModbusClient::sendReadRequest 、QModbusClient::sendWriteRequest を参照してください。QModbusClient::sendReadWriteRequest |
QModbusReply::Broadcast | 2 | 応答は、Modbus ブロードキャスト要求に由来します。serverAddress() は0 を返し、finished() シグナルが直ちに発信されます。 |
メンバ関数のドキュメント
QModbusReply::QModbusReply(QModbusReply::ReplyType type, int serverAddress, QObject *parent = nullptr)
指定されたtype とparent を使用して、QModbusReplyオブジェクトを作成します。
この応答は、serverAddress で表される Modbus クライアントに送信されます。
QModbusDevice::Error QModbusReply::error() const
この応答のエラー状態を返します。
errorString() およびerrorOccurred()も参照してください 。
[signal] void QModbusReply::errorOccurred(QModbusDevice::Error error)
このシグナルは、この応答の処理中にエラーが検出されたときに発せられます。その後、finished() シグナルが発行される可能性があります。
エラーは、エラーコード `error` で表されます。`errorString ` が空でない場合、そこにはエラーの説明文が含まれます。QModbusDevice::ProtocolError が発生した場合は、`rawResult()` 関数を使用して元の Modbus 例外応答を取得し、例外コードを確認することができます。
注:この信号に接続されたスロット内で、この応答オブジェクトを削除しないでください。代わりにdeleteLater()を使用してください。
「 error()」および「errorString()」も参照してください 。
QString QModbusReply::errorString() const
この応答のエラー状態をテキスト形式で返します。
エラーが発生していない場合、空の文字列が返されます。テキスト表現が関連付けられていないエラーが発生した可能性もあり、その場合も空の文字列が返されます。
error() およびerrorOccurred()も参照してください 。
[signal] void QModbusReply::finished()
このシグナルは、応答の処理が完了したときに発信されます。応答はエラーを伴って返されている可能性があります。
このシグナルが発火された後は、返信データの更新は行われません。
注: このシグナルに接続されたスロット内で、オブジェクトを削除しないでください 。deleteLater() を使用してください。
また、finished() シグナルを受信する前であっても、isFinished() を使用して QNetworkReply が処理を完了したかどうかを確認することもできます。
isFinished() およびerror()も参照してください 。
[since 6.0] QList<QModbusDevice::IntermediateError> QModbusReply::intermediateErrors() const
Modbusリクエストの送受信サイクル中に発生した可能性のある中間エラーのリストを、QModbusReply が処理完了を報告するまで返します。
この関数はQt 6.0で導入されました。
bool QModbusReply::isFinished() const
応答が完了したか、または中断された場合に、true を返します。
finished() およびerror()も参照してください 。
QModbusResponse QModbusReply::rawResult() const
Modbusリクエストの生の応答を返します。
リクエストがまだ完了していない場合、返されるQModbusResponse インスタンスは無効となります。
QModbusDataUnit QModbusReply::result() const
Modbusリクエストの前処理済み結果を返します。
QModbusClient::sendReadWriteRequest() を通じて送信された読み取りリクエストおよび読み取り/書き込みの複合リクエストの場合、この結果にはサーバーインスタンスから読み取られた値が含まれます。
リクエストが完了していない場合、エラーで失敗した場合、または書き込みリクエストであった場合、返されるQModbusDataUnit インスタンスは無効となります。
注: 応答のtype() がQModbusReply::Broadcastの場合 、戻り値は常に無効となります。応答のtype() がQModbusReply::Raw の場合、QModbusClient::processPrivateResponse() の実装によっては、戻り値が無効になることがあります。
type()、rawResult()、およびQModbusClient::processPrivateResponse()も参照してください 。
int QModbusReply::serverAddress() const
この応答オブジェクトが対象とするサーバーのアドレスを返します。
QModbusReply::ReplyType QModbusReply::type() const
応答の型を返します。
注: 応答の型が `QModbusReply::Raw`の場合 、result() の戻り値は常に無効となります。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.