QDataStream Class

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

QDataStream::QDataStream()

I/Oデバイスを持たないデータ・ストリームを構築する。

setDevice()も参照 。

[explicit] QDataStream::QDataStream(QIODevice *d)

I/O デバイスd を使用するデータ・ストリームを構築する。

setDevice() およびdevice()も参照のこと 。

QDataStream::QDataStream(const QByteArray &a)

バイト配列a を操作する読み取り専用のデータストリームを構築します。バイト配列に書き込みたい場合は、QDataStream(QByteArray*, int) を使用してください。

QByteArray はQIODevice のサブクラスではないので、内部的にはバイト配列をラップするためにQBuffer が作成されます。

QDataStream::QDataStream(QByteArray *a, QIODeviceBase::OpenMode mode)

バイト配列a を操作するデータストリームを構築する。mode には、デバイスの使用方法が記述されています。

また、単にバイト配列から読み取りたい場合は、QDataStream(constQByteArray &)を使用することもできます。

QByteArray はQIODevice のサブクラスではないので、内部的にはバイト配列をラップするためにQBuffer が作成されます。

[noexcept] QDataStream::~QDataStream()

データストリームを破棄する。

ただし、コンストラクタで渡されたQByteArray を処理している内部I/Oデバイス（QBuffer など）の場合は、内部I/Oデバイスが破壊されます。

void QDataStream::abortTransaction()

読み取りトランザクションを中止する。

この関数は、上位プロトコルのエラーやストリームの同期が失われた後にトランザクションを破棄するために一般的に使用される。

内側トランザクションで呼び出された場合、中止は一番外側のトランザクションに委譲され、その後に開始された内側トランザクションは強制的に失敗する。

一番外側のトランザクションでは、ストリームの復元ポイントと内部的に重複しているデータを破棄します。ストリームの現在の読み取り位置には影響しません。

データ・ストリームの状態を

startTransaction()、commitTransaction()、rollbackTransaction()も参照のこと 。

bool QDataStream::atEnd() const

I/Oデバイスが終了位置（ストリームまたはファイルの終端）に達したか、I/Oデバイスが設定されていない場合はtrue を返し、そうでない場合はfalse を返す。

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

QDataStream::ByteOrder QDataStream::byteOrder() const

現在のバイトオーダー設定（BigEndian またはLittleEndian ）を返す。

setByteOrder()も参照 。

bool QDataStream::commitTransaction()

読み取りトランザクションを完了する。トランザクション中に読み取りエラーが発生しなかった場合はtrue を返し、そうでない場合はfalse を返す。

内側のトランザクションで呼び出された場合、コミットは、一番外側の commitTransaction()、rollbackTransaction()、またはabortTransaction() の呼び出しが発生するまで延期される。

それ以外の場合、ストリーム・ステータスがデータの終端を過ぎての読み取りを示す場合、この関数はstartTransaction() を呼び出した時点までストリーム・データをリストアします。このような状況が発生した場合、データがさらに到着するのを待つ必要があり、その後に新しいトランザクションを開始する。データ・ストリームが破損したデータを読み込んだ場合、または内部トランザクションのいずれかが中止された場合、この関数はトランザクションを中止します。

startTransaction()、rollbackTransaction()、abortTransaction()も参照のこと 。

QIODevice *QDataStream::device() const

現在設定されているI/Oデバイス、または現在設定されているデバイスがない場合はnullptr を返す。

setDevice()も参照のこと 。

QDataStream::FloatingPointPrecision QDataStream::floatingPointPrecision() const

データストリームの浮動小数点精度を返す。

FloatingPointPrecision およびsetFloatingPointPrecision()も参照 。

[since 6.7] QDataStream &QDataStream::readBytes(char *&s, qint64 &l)

ストリームからバッファs を読み込み、ストリームへの参照を返す。

バッファs は、new [] を使用して割り当てられます。delete [] 。

l パラメータには、バッファの長さが設定されます。読み込んだ文字列が空の場合、l は 0 に設定され、s はnullptr に設定されます。

直列化フォーマットは、最初に長さ指定子、次にl バイトのデータである。長さ指定子は、バージョンが6.7未満の場合、または要素数が0xfffffffe（2^32 -2）未満の場合は1つのquint32となり、そうでない場合は、拡張値0xfffffffeの後に実際の値を1つのquint64が続きます。さらに、isNull() をサポートするコンテナでは、すべてのビットが設定され、データがない 1 つの quint32 としてエンコードされます。

この関数は Qt 6.7 で導入されました。

readRawData() およびwriteBytes()も参照してください 。

[until 6.11] QDataStream &QDataStream::readBytes(char *&s, uint &l)

この関数はバージョン6.11で非推奨となる予定です。

代わりに qint64 length を取るオーバーロードを使用してください。

qint64 QDataStream::readRawData(char *s, qint64 len)

ストリームから最大len バイトをs に読み込み、読み込んだバイト数を返す。エラーが発生した場合、この関数は -1 を返す。

バッファs は事前に確保されていなければならない。データはデコードされない。

readBytes()、QIODevice::read()、writeRawData()も参照のこと 。

void QDataStream::resetStatus()

データ・ストリームのステータスをリセットする。

Status 、status （）、setStatus （）も参照のこと 。

void QDataStream::rollbackTransaction()

読み取りトランザクションを取り消す。

この関数は、トランザクションをコミットする前に不完全な読み取りが検出された場合に、トランザクションをロールバックするために一般的に使用される。

内側トランザクションで呼び出された場合、トランザクションの戻しは一番外側のトランザクションに委譲され、その後に開始された内側トランザクションは強制的に失敗させられる。

一番外側のトランザクションでは、ストリーム・データをstartTransaction() の呼び出し時点にリストアする。データ・ストリームが破損したデータを読み取った場合、または内部トランザクションのいずれかが中止された場合、この関数はトランザクションを中止する。

前のストリーム操作が成功した場合は、データ・ストリームのステータスを

startTransaction （）、commitTransaction （）、abortTransaction （）も参照の こと。

void QDataStream::setByteOrder(QDataStream::ByteOrder bo)

シ リ ア ラ イ ゼーシ ョ ンのバ イ ト 順序をbo に設定 し ます。

bo パラメータにはQDataStream::BigEndian またはQDataStream::LittleEndian を指定する。

デフォルトの設定はビッグエンディアンです。特別な要件がない限り、この設定のままにしておくことを推奨します。

byteOrder()も参照 。

void QDataStream::setDevice(QIODevice *d)

void QDataStream::setDevice(QIODevice *d)

I/Oデバイスをd に設定します。nullptr で現在のI/Oデバイスへの設定を解除できます。

device()も参照してください 。

void QDataStream::setFloatingPointPrecision(QDataStream::FloatingPointPrecision precision)

データストリームの浮動小数点精度をprecision に設定する。 浮動小数点精度がDoublePrecision で、データストリームのバージョンがQt_4_6 以上の場合、すべての浮動小数点数は64ビット精度で書き込まれ、読み込まれる。浮動小数点精度がSinglePrecision で、バージョンがQt_4_6 以上の場合、すべての浮動小数点数値は32ビット精度で書き込まれ、読み込まれる。

Qt_4_6 より前のバージョンでは、データ・ストリームの浮動小数点数の精度は、呼び出されたストリー ム演算子によって異なります。

デフォルトはDoublePrecision です。

このプロパティは、qfloat16 インスタンスのシリアライズやデシリアライズに影響しないことに注意してください。

floatingPointPrecision()も参照してください 。

void QDataStream::setStatus(QDataStream::Status status)

データ・ストリームのステータスを、指定されたstatus に設定する。

それ以降のsetStatus()の呼び出しは、resetStatus()が呼び出されるまで無視される。

Status 、status()、resetStatus()も参照のこと 。

void QDataStream::setVersion(int v)

データシリアライズフォーマットのバージョン番号をVersion enum の値v に設定します。

現在のバージョンの Qt を使用している場合は、バージョンを設定する必要はありませんが、独自のバイナリ形式を使用する場合は、設定することをお勧めします。詳細説明のVersioning を参照してください。

新しい機能に対応するために、Qt のいくつかのクラスではデータストリームのシリアライズフォーマットが変更されています。以前のバージョンの Qt で作成されたデータを読み込みたい、または以前のバージョンの Qt でコンパイルされたプログラムで読み込めるデータを書き込みたい場合は、この関数を使用してQDataStream で使用されるシリアライズ形式を変更してください。

Version enum は、Qt の異なるバージョンに対応する記号定数を提供します。例えば

QDataStream out(file);
out.setVersion(QDataStream::Qt_4_0);

version() およびVersionも参照して ください。

qint64 QDataStream::skipRawData(qint64 len)

デバイスからlen バイトをスキップする。実際にスキップされたバイト数、またはエラーの場合は -1 を返す。

これは、長さlen のバッファに対してreadRawData() を呼び出し、そのバッファを無視することと等価である。

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

void QDataStream::startTransaction()

ストリーム上で新しい読み取りトランザクションを開始する。

一連の読み取り操作の中で、復元可能なポイントを定義する。シーケンシャル・デバイスの場合、読み込みデータは内部的に複製され、読み込みが不完全な場合に回復できるようになる。ランダムアクセスデバイスの場合、この関数はストリームの現在位置を保存する。commitTransaction()、rollbackTransaction()、またはabortTransaction() を呼び出して、現在のトランザクションを終了する。

トランザクションが開始されると、この関数を続けて呼び出すと、トランザクションが再帰的に実行される。内側のトランザクションは、一 番外側のトランザクションのエージェントとして動作する（つまり、読み取り操作のステータスを一 番外側のトランザクションに報告し、ストリームの位置を復元できる）。

トランザクション中にエラーが発生した場合（内部トランザクションの失敗を含む）、データ・ストリームからの読み取りは中断され（後続の読み取り操作はすべて空/ゼロ値を返す）、後続の内部トランザクションは強制的に失敗する。新しい一番外側のトランザクションを開始すると、この状態から回復する。この動作により、すべての読み取り操作を個別にエラーチェックする必要がなくなる。

commitTransaction()、rollbackTransaction()、abortTransaction()も参照のこと 。

QDataStream::Status QDataStream::status() const

データ・ストリームの状態を返す。

Status 、setStatus()、resetStatus()も参照 。

int QDataStream::version() const

データ直列化フォーマットのバージョン番号を返す。

setVersion() およびVersionも参照 。

QDataStream &QDataStream::writeBytes(const char *s, qint64 len)

長さ指定子len とバッファs をストリームに書き込み、ストリームへの参照を返します。

len は、quint32 とオプションの quint64 としてシリアライズされ、その後にs からのlen バイトが続きます。 データはエンコードされていないことに注意してください。

writeRawData() およびreadBytes()も参照してください 。

qint64 QDataStream::writeRawData(const char *s, qint64 len)

s からlen バイトをストリームに書き込む。実際に書き込まれたバイト数を返すか、エラーの場合は -1 を返す。データはエンコードされません。

writeBytes()、QIODevice::write() およびreadRawData()も参照 。

QDataStream &QDataStream::operator<<(qint8 i)

符号付きバイトi をストリームに書き込み、ストリームへの参照を返す。

QDataStream &QDataStream::operator<<(bool i)

これはオーバーロードされた関数である。

ブール値i をストリームに書き込みます。ストリームへの参照を返します。

[since 6.0] QDataStream &QDataStream::operator<<(char16_t c)

これはオーバーロードされた関数である。

文字c をストリームに書き込む。ストリームへの参照を返します。

この関数は Qt 6.0 で導入されました。

[since 6.0] QDataStream &QDataStream::operator<<(char32_t c)

これはオーバーロードされた関数である。

文字c をストリームに書き込む。ストリームへの参照を返します。

この関数は Qt 6.0 で導入されました。

QDataStream &QDataStream::operator<<(const char *s)

これはオーバーロードされた関数です。

'˶'終端の文字列s をストリームに書き込み、ストリームへの参照を返します。

文字列は、writeBytes() を使用してシリアル化されます。

writeBytes() およびwriteRawData()も参照してください 。

QDataStream &QDataStream::operator<<(double f)

これはオーバーロードされた関数である。

浮動小数点数f を標準 IEEE 754 フォーマットでストリームに書き込む。ストリームへの参照を返します。

setFloatingPointPrecision()も参照してください 。

QDataStream &QDataStream::operator<<(float f)

これはオーバーロードされた関数である。

浮動小数点数f を標準 IEEE 754 フォーマットでストリームに書き込む。ストリームへの参照を返します。

setFloatingPointPrecision()も参照してください 。

QDataStream &QDataStream::operator<<(qint16 i)

これはオーバーロードされた関数である。

符号付き 16 ビット整数i をストリームに書き込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(qint32 i)

これはオーバーロードされた関数である。

符号付き 32 ビット整数i をストリームに書き込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(qint64 i)

これはオーバーロードされた関数である。

符号付き 64 ビット整数i をストリームに書き込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(quint16 i)

これはオーバーロードされた関数である。

符号なし16ビット整数i をストリームに書き込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(quint32 i)

これはオーバーロードされた関数です。

符号なし整数i を32ビット符号なし整数（quint32）としてストリームに書き込みます。ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(quint64 i)

これはオーバーロードされた関数である。

符号なし 64 ビット整数i をストリームに書き込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(quint8 i)

これはオーバーロードされた関数である。

符号なしバイトi をストリームに書き込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator<<(std::nullptr_t ptr)

これはオーバーロードされた関数である。

std::nullptr_t,ptr をストリームに書き込むことをシミュレートし、ストリームへの参照を返します。std::nullptr_t 値は0バイトとして格納されるため、この関数は実際にはストリームに何も書き込まない。

QDataStream &QDataStream::operator>>(bool &i)

ストリームからブール値をi に読み込みます。ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(qint8 &i)

ストリームから符号付きバイトをi に読み込み、ストリームへの参照を返す。

QDataStream &QDataStream::operator>>(char *&s)

これはオーバーロードされた関数である。

ストリームから文字列s を読み込み、ストリームへの参照を返す。

文字列は、readBytes() を使用してデシリアライズされます。ここで、シ リアライズ形式は、最初にquint32 の長さ指定子があり、その後にそのバイト数のデータが続きます。結果の文字列は常に'˶0'終端である。

文字列のスペースはnew [] を使用して確保されます - 呼び出し側はdelete [] で破棄する必要があります。

readBytes() およびreadRawData()も参照してください 。

[since 6.0] QDataStream &QDataStream::operator>>(char16_t &c)

これはオーバーロードされた関数である。

ストリームから16ビット幅のcharをc に読み込み、ストリームへの参照を返します。

この関数はQt 6.0で導入されました。

[since 6.0] QDataStream &QDataStream::operator>>(char32_t &c)

これはオーバーロードされた関数である。

ストリームから32ビット幅の文字をc に読み込み、ストリームへの参照を返します。

この関数は Qt 6.0 で導入されました。

QDataStream &QDataStream::operator>>(double &f)

これはオーバーロードされた関数である。

標準IEEE 754フォーマットを使用して、ストリームから浮動小数点数をf に読み込みます。ストリームへの参照を返します。

setFloatingPointPrecision()も参照してください 。

QDataStream &QDataStream::operator>>(float &f)

これはオーバーロードされた関数である。

標準IEEE 754フォーマットを使用して、ストリームから浮動小数点数をf に読み込みます。ストリームへの参照を返します。

setFloatingPointPrecision()も参照してください 。

QDataStream &QDataStream::operator>>(qint16 &i)

これはオーバーロードされた関数である。

ストリームから符号付き16ビット整数をi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(qint32 &i)

これはオーバーロードされた関数である。

ストリームから符号付き 32 ビット整数をi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(qint64 &i)

これはオーバーロードされた関数である。

ストリームから符号付き 64 ビット整数をi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(quint16 &i)

これはオーバーロードされた関数である。

ストリームから符号なし16ビット整数をi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(quint32 &i)

これはオーバーロードされた関数である。

ストリームから符号なし32ビット整数をi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(quint64 &i)

これはオーバーロードされた関数である。

ストリームから符号なし64ビット整数をi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(quint8 &i)

これはオーバーロードされた関数である。

ストリームから符号なしバイトをi に読み込み、ストリームへの参照を返します。

QDataStream &QDataStream::operator>>(std::nullptr_t &ptr)

これはオーバーロードされた関数である。

ストリームからstd::nullptr_t をptr に読み込むことをシミュレートし、ストリームへの参照を返します。std::nullptr_t の値は 0 バイトとして格納されるため、この関数は実際にはストリームから何も読み取りません。