QSerialPort 类

int numRead = 0, numReadTotal = 0;
char buffer[50];

for (;;) {
    numRead  = serial.read(buffer, 50);

    // Do whatever with the array

    numReadTotal += numRead;
    if (numRead == 0 && !serial.waitForReadyRead())
        break;
}

成员函数文档

[显式] QSerialPort::QSerialPort(QObject *parent = nullptr)

构建一个新的串行端口对象，具有给定的parent。

[显式] QSerialPort::QSerialPort(const QString &name, QObject *parent = nullptr)

构建一个新的串行端口对象，具有给定的parent，以表示具有指定name的串行端口。

名称应具有特定的格式；请参阅setPort()方法。

[显式] QSerialPort::QSerialPort(const QSerialPortInfo &serialPortInfo, QObject *parent = nullptr)

构造一个新串行端口对象，具有给定的parent，以表示具有指定的辅助类serialPortInfo的串行端口。

[虚（noexcept）] QSerialPort::~QSerialPort()

如果需要，关闭串行端口，然后销毁对象。

[信号] void QSerialPort::baudRateChanged(qint32 baudRate, QSerialPort::Directions directions)

更改波特率后发出该信号。新波特率作为baudRate传递，方向作为directions传递。

另请参阅 QSerialPort::baudRate。

[重写虚函数] qint64 QSerialPort::bytesAvailable() const

重实现：QIODevice::bytesAvailable() const。

返回等待读取的输入字节数。

另请参阅 bytesToWrite() 和 read().

[重写虚函数] qint64 QSerialPort::bytesToWrite() const

重新实现了：QIODevice::bytesToWrite() const.

返回等待写入的字节数。当控制权返回到事件循环或调用 flush() 时写入字节。

另请参阅 bytesAvailable() 和 flush().

[重写虚函数] bool QSerialPort::canReadLine() const

重新实现了：QIODevice::canReadLine() const.

如果可以从串行端口读取一行数据，则返回 true；否则返回 false。

另请参阅 readLine().

bool QSerialPort::clear(QSerialPort::Directions directions = AllDirections)

根据给定的方向 directions 抛弃输出或输入缓冲区中的所有字符。这包括清除内部类缓冲区和 UART（驱动程序）缓冲区。同时终止挂起的读或写操作。如果成功，返回 true；否则返回 false。

[重写虚函数] void QSerialPort::close()

重新实现了：QIODevice::close().

另请参阅 QIODevice::close().

[信号] void QSerialPort::dataBitsChanged(QSerialPort::DataBits dataBits)

在帧中的数据位已更改后发出此信号。新帧中的数据位作为 dataBits 传递。

另请参阅 QSerialPort::dataBits。

[信号] void QSerialPort::dataTerminalReadyChanged(bool set)

在信号线路 DTR 的状态（高或低）更改后发出此信号。通过 set 传递新线信号 DTR 的状态（高或低）。

另请参阅 QSerialPort::dataTerminalReady.

[信号] void QSerialPort::errorOccurred(QSerialPort::SerialPortError error)

当串行端口发生错误时发出此信号。指定的 error 描述了发生的错误类型。

另请参阅QSerialPort::error。

[信号] void QSerialPort::flowControlChanged(QSerialPort::FlowControl flow)

该信号在流量控制模式改变后发出。新的流量控制模式作为 flow 传递。

另请参阅 QSerialPort::flowControl。

bool QSerialPort::flush()

此函数尽可能将内部写入缓冲区中的数据写入到底层串行端口，而不进行阻塞。如果已写入任何数据，则此函数返回 true；否则返回 false。

调用此函数以将缓冲数据立即发送到串行端口。成功写入的字节数取决于操作系统。在大多数情况下，不需要调用此函数，因为 QSerialPort 类将自动开始发送数据，一旦事件循环返回控制权。如果没有事件循环，则替换为调用 waitForBytesWritten()。

另请参阅：write() 和 waitForBytesWritten。

QSerialPort::Handle QSerialPort::handle() const

如果平台受支持且串行端口已打开，则返回本机串行端口句柄；否则返回 -1。

[重写虚函数] bool QSerialPort::isSequential() const

重新实现了： QIODevice::isSequential() const。

总是返回 true。串行端口是顺序设备。

[重写虚函数] bool QSerialPort::open(QIODeviceBase::OpenMode mode)

重新实现了： QIODevice::open(QIODeviceBase::OpenMode mode)。

使用 OpenMode mode 打开串行端口，如果成功则返回 true；否则返回 false 并设置错误代码，该代码可以通过调用 error() 方法获取。

另请参阅：QIODeviceBase::OpenMode 和 setPort。

[信号] void QSerialPort::parityChanged(QSerialPort::Parity parity)

当奇偶校验位检查模式更改后，将发出此信号。新的奇偶校验位检查模式作为 parity 传递。

另请参阅 QSerialPort::parity。

QSerialPort::PinoutSignals QSerialPort::pinoutSignals()

以位图格式返回线信号的当前状态。

从该结果中，可以通过应用“与”掩码（其中掩码是来自 QSerialPort::PinoutSignals 的所需的枚举值）来分配所需信号的当前状态。

另请参阅QSerialPort::dataTerminalReady 和 QSerialPort::requestToSend。

QString QSerialPort::portName() const

返回由 setPort() 设置或传递给 QSerialPort 构造函数的名称。该名称很短，即是从设备的内部变量系统位置提取和转换的。转换算法是平台特定的。

另请参阅setPortName()，setPort() 和 QSerialPortInfo::portName。

qint64 QSerialPort::readBufferSize() const

返回内部读取缓冲区的大小。这限制了在调用 read() 或 readAll 方法之前客户端可以接收的数据量。

读取缓冲区大小为 0（默认值）表示没有大小限制，确保不会丢失数据。

另请参阅setReadBufferSize() 和 read。

[重写虚拟受保护的] qint64 QSerialPort::readData(char *data, qint64 maxSize)

重新实现了： QIODevice::readData(char *data, qint64 maxSize).

[重写虚拟受保护的] qint64 QSerialPort::readLineData(char *data, qint64 maxSize)

重新实现： QIODevice::readLineData(char *data, qint64 maxSize)。

[信号] void QSerialPort::requestToSendChanged(bool set)

当行信号 RTS 的状态（高或低）改变后，会发出此信号。新的行信号 RTS 的状态（高或低）作为 set 传递。

另请参阅：QSerialPort::requestToSend。

void QSerialPort::setPort(const QSerialPortInfo &serialPortInfo)

设置存储在串行端口信息实例 serialPortInfo 中的端口。

另请参阅：portName() 和 QSerialPortInfo。

void QSerialPort::setPortName(const QString &name)

设置串行端口的 名称。

串行端口的名称可以是简称或系统位置的完整名称，如有必要。

另请参阅：portName() 和 QSerialPortInfo。

void QSerialPort::setReadBufferSize(qint64 size)

将 QSerialPort 的内部读取缓冲区大小设置为 size 字节。

如果缓冲区大小限制为一定大小，则 QSerialPort 不会缓存超过这个大小的数据。特殊情况下缓冲区大小为 0 表示读取缓冲区为无限大，所有传入的数据都将被缓存。这是默认值。

如果数据只在特定时间点读取（例如在实时流应用中）或如果需要保护串行端口免收过多数据，这可能导致应用程序耗尽内存，则此选项非常有用。

另请参阅：readBufferSize() 和 read。

[信号] void QSerialPort::stopBitsChanged(QSerialPort::StopBits stopBits)

在一个帧中的停止位数改变后，会发出此信号。新的停止位数作为 stopBits 传递。

另请参阅QSerialPort::stopBits。

[重载虚拟] bool QSerialPort::waitForBytesWritten(int msecs = 30000)

重新实现：QIODevice::waitForBytesWritten(int msecs)。

此函数将阻塞，直到至少有一个字节写入串行端口并发出 bytesWritten() 信号。函数将在 msecs 毫秒后超时；默认超时时间为 30000 毫秒。如果 msecs 为 -1，则此函数不会超时。

如果发出 bytesWritten() 信号，函数返回 true；否则返回 false（如果发生错误或操作超时）。

[重载虚拟] bool QSerialPort::waitForReadyRead(int msecs = 30000)

重实现：QIODevice::waitForReadyRead(int msecs).

此函数在可读数据可用时阻塞，直到发出 readyRead() 信号。该函数将在 msecs 毫秒后超时；默认超时时间为 30000 毫秒。如果 msecs 为 -1，则此函数不会超时。

如果发出 readyRead() 信号且可读数据可用，则该函数返回 true；否则返回 false（如果发生错误或操作超时）。

另请参阅waitForBytesWritten().

[重写虚拟受保护] qint64 QSerialPort::writeData(const char *data, qint64 maxSize)

重实现：QIODevice::writeData(const char *data, qint64 maxSize).