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()

データ・ストリームを破棄します。

デストラクタは現在のI/Oデバイスには影響しない。ただし、コンストラクタで渡された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()も参照してください 。

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)

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

標準 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)

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

符号なし整数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 バイトとして格納されるため、この関数は実際にはストリームから何も読み取りません。