QModbusReply Class
The QModbusReply class contains the data for a request sent with a QModbusClient derived class. More...
Header: | #include <QModbusReply> |
qmake: | QT += serialbus |
Since: | Qt 5.8 |
Inherits: | QObject |
Public Types
enum | ReplyType { Raw, Common } |
Public Functions
QModbusReply(ReplyType type, int serverAddress, QObject *parent = nullptr) | |
QModbusDevice::Error | error() const |
QString | errorString() const |
bool | isFinished() const |
QModbusResponse | rawResult() const |
QModbusDataUnit | result() const |
int | serverAddress() const |
ReplyType | type() const |
- 31 public functions inherited from QObject
Signals
void | errorOccurred(QModbusDevice::Error error) |
void | finished() |
- 2 signals inherited from QObject
Additional Inherited Members
- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 11 static public members inherited from QObject
- 9 protected functions inherited from QObject
Detailed Description
The QModbusReply class contains the data for a request sent with a QModbusClient derived class.
Member Type Documentation
enum QModbusReply::ReplyType
This enum describes the possible reply type.
Constant | Value | Description |
---|---|---|
QModbusReply::Raw | 0 | The reply originates from a raw Modbus request. See QModbusClient::sendRawRequest |
QModbusReply::Common | 1 | The reply originates from a common read, write or read/write request. See QModbusClient::sendReadRequest, QModbusClient::sendWriteRequest and QModbusClient::sendReadWriteRequest |
Member Function Documentation
QModbusReply::QModbusReply(ReplyType type, int serverAddress, QObject *parent = nullptr)
Constructs a QModbusReply object with a given type and the specified parent.
The reply will be send to the Modbus client represented by serverAddress.
QModbusDevice::Error QModbusReply::error() const
Returns the error state of this reply.
[signal]
void QModbusReply::errorOccurred(QModbusDevice::Error error)
This signal is emitted when an error has been detected in the processing of this reply. The finished() signal will probably follow.
The error will be described by the error code error. If errorString is not empty it will contain a textual description of the error. In case of a QModbusDevice::ProtocolError the rawResult() function can be used to obtain the original Modbus exception response to get the exception code.
Note: Do not delete this reply object in the slot connected to this signal. Use deleteLater() instead.
QString QModbusReply::errorString() const
Returns the textual representation of the error state of this reply.
If no error has occurred this will return an empty string. It is possible that an error occurred which has no associated textual representation, in which case this will also return an empty string.
See also error() and errorOccurred().
[signal]
void QModbusReply::finished()
This signal is emitted when the reply has finished processing. The reply may still have returned with an error.
After this signal is emitted, there will be no more updates to the reply's data.
Note: Do not delete the object in the slot connected to this signal. Use deleteLater().
You can also use isFinished() to check if a QNetworkReply has finished even before you receive the finished() signal.
See also isFinished() and error().
bool QModbusReply::isFinished() const
Returns true
when the reply has finished or was aborted.
QModbusResponse QModbusReply::rawResult() const
Returns the raw response of a Modbus request.
If the request has not finished then the returned QModbusResponse instance is invalid.
QModbusDataUnit QModbusReply::result() const
Returns the preprocessed result of a Modbus request.
For read requests as well as combined read/write requests send via QModbusClient::sendReadWriteRequest() it contains the values read from the server instance.
If the request has not finished, has failed with an error or was a write request then the returned QModbusDataUnit instance is invalid.
Note: If the type() of the reply is QModbusReply::Raw, the return value will always be invalid.
See also type() and rawResult().
int QModbusReply::serverAddress() const
Returns the server address that this reply object targets.
ReplyType QModbusReply::type() const
Returns the type of the reply.
Note: If the type of the reply is QModbusReply::Raw, the return value of result() will always be invalid.
© 2017 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.