QSerialPort Class

qint64 numReadTotal = 0;
char buffer[50];

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

    // Do whatever with the array

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

メンバー関数ドキュメント

[explicit] QSerialPort::QSerialPort(QObject *parent = nullptr)

与えられたparent で新しいシリアルポートオブジェクトを構築する。

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

指定されたヘルパークラスserialPortInfo でシリアルポートを表すために、与えられたparent で新しいシリアルポートオブジェクトを構築します。

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

指定されたname を持つシリアル・ポートを表すために、与えられたparent を持つ新しいシリアル・ポート・オブジェクトを構築する。

setPort() メソッドを参照のこと。

[virtual noexcept] QSerialPort::~QSerialPort()

必要であればシリアルポートを閉じ、オブジェクトを破棄する。

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

このシグナルはボーレートが変更された後に発せられる。新しいボーレートはbaudRate として、方向はdirections として渡される。

QSerialPort::baudRateも参照 。

[override virtual] qint64 QSerialPort::bytesAvailable() const

再実装：QIODevice::bytesAvailable() const.

読み込み待ちの受信バイト数を返す。

bytesToWrite() およびread()も参照 。

[override virtual] qint64 QSerialPort::bytesToWrite() const

再実装：QIODevice::bytesToWrite() const.

書き込み待ちのバイト数を返す。このバイト数は、制御がイベントループに戻るか、flush() が呼ばれたときに書き込まれる。

bytesAvailable() およびflush()も参照 。

[override virtual] bool QSerialPort::canReadLine() const

再実装：QIODevice::canReadLine() const.

シリアルポートからデータの行を読み込める場合はtrue を返し、そうでない場合はfalse を返す。

readLine()も参照 。

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

指定された方向に応じて、出力バッファまたは入力バッファからすべての文字を破棄しますdirections 。これには、内部クラス・バッファとUART（ドライバ）バッファのクリアも含まれます。また、保留中の読み取りまたは書き込み操作を終了する。成功すればtrue を返し、そうでなければfalse を返す。

[override virtual] void QSerialPort::close()

再インプリメント：QIODevice::close().

QIODevice::close()も参照のこと 。

[signal] void QSerialPort::dataBitsChanged(QSerialPort::DataBits dataBits)

このシグナルは、フレーム内のデータビットが変更された後に発せられる。フレームの新しいデータビットはdataBits として渡される。

QSerialPort::dataBitsも参照してください 。

[signal] void QSerialPort::dataTerminalReadyChanged(bool set)

この信号は、ライン信号DTRの状態（ハイまたはロー）が変更された後に発せられる。回線信号DTRの新しい状態（HighまたはLow）は、set として渡される。

QSerialPort::dataTerminalReadyも参照のこと 。

[signal] void QSerialPort::errorOccurred(QSerialPort::SerialPortError error)

このシグナルは、シリアル・ポートでエラーが発生したときに発せられる。指定されたerror には、発生したエラーのタイプが記述される。

QSerialPort::errorも参照 。

[signal] void QSerialPort::flowControlChanged(QSerialPort::FlowControl flow)

このシグナルは、フロー制御モードが変更された後に発せられる。新しいフロー制御モードはflow として渡される。

QSerialPort::flowControlも参照 。

bool QSerialPort::flush()

この関数は、内部書き込みバッファから基礎となるシリアル・ポートへ、ブロッキングせずに可能な限り書き込みを行う。何らかのデータが書き込まれた場合、この関数はtrue を返し、そうでない場合はfalse を返す。

バッファリングされたデータを直ちにシリアル・ポートに送信するには、この関数を呼 び出します。書き込みに成功したバイト数はオペレーティング・システムによって異なります。ほとんどの場合、イベント・ループに制御が戻るとQSerialPort クラスが自動的にデータ送信を開始するので、この関数を呼び出す必要はありません。イベント・ループがない場合は、代わりにwaitForBytesWritten() を呼び出してください。

write() およびwaitForBytesWritten()も参照の こと。

QSerialPort::Handle QSerialPort::handle() const

プラットフォームがサポートされており、シリアルポートがオープンされている場合は、ネイティブのシリアルポートハンドルを返します。そうでない場合は、-1 を返します。

[override virtual] bool QSerialPort::isSequential() const

再実装：QIODevice::isSequential() const.

常にtrue を返す。シリアルポートはシーケンシャルデバイスです。

[override virtual] bool QSerialPort::open(QIODeviceBase::OpenMode mode)

再インプリメント：QIODevice::open(QIODeviceBase::OpenMode mode).

OpenModemode を使用してシリアル・ポートをオープンし、成功した場合はtrue を返します。そうでない場合はfalse を返し、error() メソッドを呼び出すことで取得できるエラー・コードを設定します。

このメソッドは、ポートのオープンには成功したが、ポート設定のいずれかを正常に設定できなかった場合にfalse を返します。この場合、不正な設定のままポートを放置しないように、ポートは自動的にクローズされます。

QIODeviceBase::OpenMode およびsetPort()も参照のこと 。

[signal] void QSerialPort::parityChanged(QSerialPort::Parity parity)

このシグナルは、パリティ検査モードが変更された後に発せられる。新しいパリティ検査モードはparity として渡される。

QSerialPort::parityも参照 。

QSerialPort::PinoutSignals QSerialPort::pinoutSignals()

ライン信号の状態をビットマップ形式で返す。

この結果から、マスク "AND "を適用することで、希望する信号の状態を割り当てることができる。マスクは、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()も参照 。

[override virtual protected] qint64 QSerialPort::readData(char *data, qint64 maxSize)

再実装：QIODevice::readData(char *data, qint64 maxSize).

[override virtual protected] qint64 QSerialPort::readLineData(char *data, qint64 maxSize)

再実装：QIODevice::readLineData(char *data, qint64 maxSize).

[signal] 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)

シリアル・ポートのname を設定する。

シリアル・ポートの名前は、必要に応じて、短い名前または長いシステム位置として渡すことができる。

portName() およびQSerialPortInfoも参照のこと 。

void QSerialPort::setReadBufferSize(qint64 size)

QSerialPort の内部読み込みバッファーのサイズをsize バイトに設定する。

バッファサイズがあるサイズに制限されている場合、QSerialPort はこのサイズを超えるデータをバッファリングしない。バッファサイズが0 の特別な場合は、読み込みバッファが無制限であり、すべての受信データがバッファリングされることを意味する。これがデフォルトである。

このオプションは、データが特定の時点でのみ読み込まれる場合（例えばリアルタイム・ストリーミング・アプリケーションなど）や、シリアル・ポートがデータを受信しすぎてアプリケーションがメモリ不足にならないように保護する必要がある場合に便利です。

readBufferSize() およびread()も参照の こと。

[signal] void QSerialPort::stopBitsChanged(QSerialPort::StopBits stopBits)

このシグナルは、フレームのストップビット数が変更された後に発せられる。フレームの新しいストップビット数はstopBits として渡される。

QSerialPort::stopBitsも参照してください 。

[override virtual] bool QSerialPort::waitForBytesWritten(int msecs = 30000)

再インプリメント：QIODevice::waitForBytesWritten(int msecs)。

この関数は、少なくとも1バイトがシリアルポートに書き込まれ、bytesWritten() シグナルが発せられるまでブロックする。この関数は、msecs ミリ秒後にタイムアウトします。デフォルトのタイムアウトは 30000 ミリ秒です。msecs が -1 の場合、この関数はタイムアウトしない。

この関数は、bytesWritten （）シグナルが発せられた場合はtrue を返し、そうでない場合はfalse を返す（エラーが発生した場合、または操作がタイムアウトした場合）。

[override virtual] bool QSerialPort::waitForReadyRead(int msecs = 30000)

再インプリメント：QIODevice::waitForReadyRead(int msecs)。

この関数は、新しいデータが読み込み可能になり、readyRead() シグナルが発せられるまでブロックする。この関数は、msecs ミリ秒後にタイムアウトする。デフォルトのタイムアウトは 30000 ミリ秒である。msecs が -1 の場合、この関数はタイムアウトしない。

この関数は、readyRead() シグナルが発せられ、読み取り可能な新しいデータがある場合はtrue を返し、そうでない場合はfalse を返す（エラーが発生したか、操作がタイムアウトした場合）。

waitForBytesWritten()も参照のこと 。

[override virtual protected] qint64 QSerialPort::writeData(const char *data, qint64 maxSize)

再実装：QIODevice::writeData(const char *data, qint64 maxSize).