QCborStreamReader Class

メンバ関数ドキュメント

QCborStreamReader::QCborStreamReader()

ソースデータを持たないQCborStreamReaderオブジェクトを作成します。作成後、QCborStreamReader は解析エラーを報告します。

データを追加するには、addData （）を呼び出すか、setDevice （）を使用して別のソース・デバイスを設定する。

addData() およびisValid()も参照の こと。

[explicit] QCborStreamReader::QCborStreamReader(QIODevice *device)

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

device から読み込んだ CBOR ストリームを解析する QCborStreamReader オブジェクトを作成します。QCborStreamReaderはdevice の所有権を持たないため、このオブジェクトが破棄されるまで有効である必要があります。

[explicit] QCborStreamReader::QCborStreamReader(const QByteArray &data)

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

data で見つかった CBOR ストリームを解析する QCborStreamReader オブジェクトを作成します。

QCborStreamReader::QCborStreamReader(const char *data, qsizetype len)

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

data から始まるlen バイトのデータを持つ QCborStreamReader オブジェクトを作成します。このポインターは、QCborStreamReaderが破棄されるまで有効です。

QCborStreamReader::QCborStreamReader(const quint8 *data, qsizetype len)

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

data から始まるlen バイトのデータを持つ QCborStreamReader オブジェクトを作成します。このポインタはQCborStreamReaderが破棄されるまで有効でなければなりません。

[noexcept] QCborStreamReader::~QCborStreamReader()

このQCborStreamReader オブジェクトを破棄し、関連するリソースを解放します。

void QCborStreamReader::addData(const QByteArray &data)

CBOR ストリームにdata を追加し、現在のエレメントを解析し直します。この関数は、ストリームの処理中にデータの終端に達したが、さらにデータが利用可能になった場合に便利です。

void QCborStreamReader::addData(const char *data, qsizetype len)

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

data から始まるlen バイトのデータをCBORストリームに追加し、現在の要素を解析し直す。この関数は、ストリームの処理中にデータの終端に達したが、より多くのデータが利用可能になった場合に有用である。

void QCborStreamReader::addData(const quint8 *data, qsizetype len)

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

data から始まるlen バイトのデータをCBORストリームに追加し、現在の要素を解析し直す。この関数は、ストリーム処理中にデータの終端に達したが、さらにデータが利用可能になった場合に有用である。

void QCborStreamReader::clear()

デコーダーの状態をクリアし、入力ソースデータを空のバイト配列にリセットする。この関数が呼ばれた後、QCborStreamReader は解析エラーを示す。

解析するデータを追加するには、addData （）を呼び出す。

reset() およびsetDevice()も参照 。

int QCborStreamReader::containerDepth() const

このストリームがenterContainer() で入ったコンテナのうち、まだ出ていないコンテナの数を返します。

enterContainer() およびleaveContainer() も参照 。

qint64 QCborStreamReader::currentOffset() const

現在デコード中の項目の入力ストリーム内のオフセットを返します。現在のオフセットは、ソースデータがQByteArray であるか、デコード開始時に先頭に位置していたQIODevice である場合にのみ、それまでにデコードされたバイト数となる。

reset()、clear()、device()も参照 。

qsizetype QCborStreamReader::currentStringChunkSize() const

現在のテキストまたはバイト文字列チャンクのサイズを返す。CBORストリームにチャンクされていない文字列が含まれる場合（つまり、isLengthKnown() がtrue を返す場合）、この関数は、length() と同じ、文字列全体のサイズを返します。

この関数は、後でreadStringChunk() に渡すバッファのポインタを事前に確保するのに便利です。

readString()、readByteArray()、readStringChunk()も参照 。

QIODevice *QCborStreamReader::device() const

setDevice() またはQCborStreamReader コンストラクタで設定されたQIODevice を返す。このオブジェクトがQByteArray から読み込んでいた場合、この関数は代わりに nullptr を返します。

setDevice()も参照 。

bool QCborStreamReader::enterContainer()

現在の項目である配列またはマップに入り、コンテナに含まれる要素を反復処理する準備をします。コンテナへの入力が成功した場合は true を返し、そうでない場合は false を返します（通常は解析エラー）。enterContainer() を呼び出すたびに、leaveContainer() を呼び出す必要があります。

この関数は、現在の項目が配列またはマップである場合（つまり、isArray()、isMap()、またはisContainer() が真である場合）にのみ呼び出すことができます。それ以外の条件でこの関数を呼び出すとエラーになります。

leaveContainer()、isContainer()、isArray() およびisMap()も参照 。

[noexcept] bool QCborStreamReader::hasNext() const

現在のコンテナ内にデコードすべき項目がまだある場合は真を、コンテナの終端に達した場合は偽を返す。ルート要素をパースしている場合、hasNext() が false を返すと、パースが完了したことになります。そうでない場合、コンテナの深さが 0 以外の場合は、外側のコードでleaveContainer() を呼び出す必要があります。

parentContainerType()、containerDepth()、leaveContainer()も参照 。

bool QCborStreamReader::isArray() const

現在の要素の型が配列の場合、true を返します（つまり、type() がQCborStreamReader::Array を返す場合）。この関数が真を返した場合、enterContainer() を呼び出して、そのコンテナの解析を開始できます。

現在の要素が配列の場合、isLengthKnown （）をコールして、配列のサイズが CBORストリームで明示されているかどうかを調べることもできる。もしそうであれば、length （）を呼び出すことで、そのサイズを取得することができる。

以下の例では、より効率的なデコードのために、配列のサイズを指定してQVariantList ：

   QVariantList populateFromCbor(QCborStreamReader &reader)
   {
       QVariantList list;
       if (reader.isLengthKnown())
           list.reserve(reader.length());

       reader.enterContainer();
       while (reader.lastError() == QCborError::NoError && reader.hasNext())
           list.append(readOneElement(reader));
       if (reader.lastError() == QCborError::NoError)
           reader.leaveContainer();
   }

type()、isMap()、isLengthKnown()、length()、enterContainer()、leaveContainer()も参照 。

bool QCborStreamReader::isBool() const

現在の要素が真偽値 (true またはfalse) の場合は真を、それ以外の場合は偽を返します。この関数が true を返した場合は、toBool() を呼び出してブーリアン値を取得できます。また、toSimpleType() を呼び出し、QCborSimpleValue::True または QCborSimpleValue::False と比較することもできます。

type()、isFalse()、isTrue()、toBool()、isSimpleType()、toSimpleType()も参照してください 。

bool QCborStreamReader::isByteArray() const

現在の要素の型がバイト配列の場合（つまり、type() がQCborStreamReader::ByteArray を返す場合）、true を返します。この関数が真を返した場合、readByteArray() を呼び出して、そのデータを読み込むことができます。

type()、readByteArray()、isString()も参照 。

bool QCborStreamReader::isContainer() const

現在の要素がコンテナ（つまり、配列またはマップ）の場合は true を返し、それ以外の場合は false を返します。現在の要素がコンテナである場合、isLengthKnown() 関数を使用して、コンテナのサイズがストリーム内で明示されているかどうかを調べ、明示されている場合は、length() を使用してそのサイズを取得することができます。

さらに重要なのは、コンテナに対してenterContainer() 関数を使用し、コンテナに含まれる要素の反復処理を開始できることである。

type(),isArray(),isMap(),isLengthKnown(),length(),enterContainer(),leaveContainer(),containerDepth()も参照 。

bool QCborStreamReader::isDouble() const

現在の要素の型が IEEE 754 倍精度浮動小数点の場合、true を返します（つまり、type() がQCborStreamReader::Double を返す場合）。この関数が真を返した場合、toDouble() を呼び出して、そのデータを読み込むことができます。

type()、toDouble()、isFloat16()、isFloat()も参照 。

bool QCborStreamReader::isFalse() const

現在の要素がfalse の値の場合は true を返し、それ以外の場合は false を返します。

type()、isTrue()、isBool()、toBool()、isSimpleType()、toSimpleType()も参照 。

bool QCborStreamReader::isFloat16() const

現在の要素の型が IEEE 754 半精度浮動小数点の場合、true を返します（つまり、type() がQCborStreamReader::Float16 を返す場合）。この関数が真を返した場合、toFloat16() を呼び出して、そのデータを読み込むことができます。

type()、toFloat16()、isFloat()、isDouble()も参照 。

bool QCborStreamReader::isFloat() const

現在の要素の型が IEEE 754 単精度浮動小数点の場合（つまり、type() がQCborStreamReader::Float を返す場合）、true を返します。この関数が真を返した場合、toFloat() を呼び出して、そのデータを読み込むことができます。

type()、toFloat()、isFloat16()、isDouble()も参照 。

bool QCborStreamReader::isInteger() const

現在の要素の型が符号なし整数または負の整数である場合（つまり、type() がQCborStreamReader::UnsignedInteger またはQCborStreamReader::NegativeInteger を返す場合）、true を返します。この関数が真を返した場合、toInteger() を呼び出してその値を読み込むことができます。

type()、toInteger()、toUnsignedInteger()、toNegativeInteger()、isUnsignedInteger()、isNegativeInteger()も参照 。

bool QCborStreamReader::isInvalid() const

現在の要素が無効な場合は真を、そうでない場合は偽を返します。現在の要素が無効なのは、デコード・エラーがあった場合や、配列やマップの最後の要素をパースした場合などです。

type() およびisValid()も参照 。

[noexcept] bool QCborStreamReader::isLengthKnown() const

現在の配列、マップ、バイト配列、文字列の長さが既知（CBORストリームで明示的）の場合はtrueを返し、そうでない場合はfalseを返します。この関数は、要素がこれらのいずれかである場合にのみ呼び出されるべきです。

長さが既知の場合は、length （）を呼び出すことで取得できます。

マップや配列の長さが既知でない場合、それはストリームに存在する要素数によって暗示されます。QCborStreamReader は、そのような状態で長さを計算するAPIを持っていません。

文字列やバイト配列も、長さが不定になる可能性があります（つまり、複数のチャンクで送信される可能性があります）。これらは現在のところQCborStreamWriter では作成できませんが、他のエンコーダーでは作成できる可能性があるので、QCborStreamReader ではサポートしています。

length()、QCborStreamWriter::startArray()、QCborStreamWriter::startMap()も参照のこと 。

bool QCborStreamReader::isMap() const

現在の要素の型がマップの場合、true を返します（つまり、type() がQCborStreamReader::Map を返す場合）。この関数が真を返した場合、enterContainer() を呼び出して、そのコンテナの解析を開始できます。

現在の要素がマップである場合、isLengthKnown （）を呼び出して、マップのサイズがCBORストリームで明示されているかどうかを調べることもできる。もしそうであれば、length （）を呼び出すことで、そのサイズを取得することができる。

以下の例では、より効率的なデコードのために、マップのサイズを指定してQVariantMap を事前に割り当てています：

   QVariantMap populateFromCbor(QCborStreamReader &reader)
   {
       QVariantMap map;
       if (reader.isLengthKnown())
           map.reserve(reader.length());

       reader.enterContainer();
       while (reader.lastError() == QCborError::NoError && reader.hasNext()) {
           QString key = readElementAsString(reader);
           map.insert(key, readOneElement(reader));
       }
       if (reader.lastError() == QCborError::NoError)
           reader.leaveContainer();
   }

上の例では、readElementAsString という関数を使用してマップのキーを読み取り、文字列を取得している。CBORマップは文字列だけでなく、どんな型でもキーとして含むことができるからだ。ユーザー・コードはこの変換を行うか、文字列でないキーを拒否するか、あるいはQVariantMap やQVariantHash 以外の別のコンテナを使用する必要がある。例えば、マップが整数のキーを含むと予想される場合、ストリームのサイズと構文解析を軽減するために推奨される、正しいコンテナは\l{QMap}<int, QVariant> または\l{QHash}<int, QVariant> であろう。

type()、isArray()、isLengthKnown()、length()、enterContainer()、leaveContainer()も参照 。

bool QCborStreamReader::isNegativeInteger() const

現在の要素の型が負の整数の場合、true を返します（つまり、type() がQCborStreamReader::NegativeInteger を返す場合）。この関数が真を返した場合、toNegativeInteger() またはtoInteger() を呼び出して、その値を読み込むことができます。

type()、toNegativeInteger()、toInteger()、isInteger()、isUnsignedInteger()も参照 。

bool QCborStreamReader::isNull() const

現在の要素がnull の値であれば真を、それ以外であれば偽を返します。Null 値は、オプションのデータがないことを示すために使用できます。

type()、isSimpleType()、toSimpleType()も参照 。

bool QCborStreamReader::isSimpleType() const

現在の要素の型が、nullやundefinedだけでなく、ブーリアン値（trueやfalse）を含む、任意のCBOR単純型の場合にtrueを返します。どの単純型かを調べるには、toSimpleType() を呼び出します。あるいは、特定の単純型をテストするには、QCborSimpleType パラメータを取るオーバーロードを呼び出します。

CBOR単純型は、余分な値を持たない型である。255の可能性があるが、現在定義された意味を持つ値は4つしかない。コードは未知の単純型に対処することは期待されておらず、未知の単純型が見つかれば、単にストリームを無効として破棄するかもしれない。

QCborSimpleType 、type()、isSimpleType(QCborSimpleType)、toSimpleType()も参照 。

bool QCborStreamReader::isSimpleType(QCborSimpleType st) const

現在の要素の型が単純型st である場合は true を返し、そうでない場合は false を返します。この関数が真を返す場合、toSimpleType() はst を返します。

CBOR単純型は、余分な値を持たない型である。255の可能性があるが、現在定義された意味を持つ値は4つしかない。コードは、未知の単純型に対処することは期待されておらず、未知の単純型が見つかれば、単にストリームを無効として破棄するかもしれない。

QCborSimpleType 、type()、isSimpleType()、toSimpleType()も参照のこと 。

bool QCborStreamReader::isString() const

現在の要素の型がテキスト文字列の場合、true を返します（つまり、type() がQCborStreamReader::String を返す場合）。この関数が真を返した場合、readString() を呼び出して、そのデータを読み込むことができます。

type()、readString()、isByteArray()も参照 。

bool QCborStreamReader::isTag() const

現在の要素の型が CBOR タグである場合（つまり、type() がQCborStreamReader::Tag を返す場合）、true を返します。この関数が真を返した場合、toTag() を呼び出して、そのデータを読み込むことができます。

type() およびtoTag()も参照 。

bool QCborStreamReader::isTrue() const

現在の要素がtrue の値の場合は true を返し、それ以外の場合は false を返します。

type()、isFalse()、isBool()、toBool()、isSimpleType()、toSimpleType()も参照 。

bool QCborStreamReader::isUndefined() const

現在の要素がundefined の値であれば真を、それ以外であれば偽を返します。未定義の値は、ストリームの作成時に何らかの変換に失敗したか、変換できなかったことを示すためにエンコードされることがあります。QCborStreamReader は決して置換を行わず、この関数は、ストリームに明示的な未定義の値が含まれている場合にのみ真を返します。

type()、isSimpleType()、toSimpleType()も参照 。

bool QCborStreamReader::isUnsignedInteger() const

現在の要素の型が符号なし整数である場合（つまり、type() がQCborStreamReader::UnsignedInteger を返す場合）、true を返します。この関数が真を返した場合、toUnsignedInteger() またはtoInteger() を呼び出して、その値を読み込むことができます。

type()、toUnsignedInteger()、toInteger()、isInteger()、isNegativeInteger()も参照 。

bool QCborStreamReader::isValid() const

現在の要素が有効な場合は真を、そうでない場合は偽を返します。現在の要素が無効なのは、デコードエラーがあった場合や、配列やマップの最後の要素をパースした場合などです。

type() およびisInvalid()も参照 。

QCborError QCborStreamReader::lastError() const

ストリームのデコードで最後にエラーが発生した場合、そのエラーを返します。エラーが発生しなかった場合は、QCborError::NoError を返します。

isValid()も参照 。

bool QCborStreamReader::leaveContainer()

アイテムが処理されていた配列またはマップを離れ、コンテナの終端の次のアイテムにデコーダを配置します。コンテナからの離脱に成功した場合は true を返し、失敗した場合は false を返します (通常は解析エラー)。enterContainer() を呼び出すたびに、leaveContainer() を呼び出す必要がある。

この関数は、hasNext() が false を返し、containerDepth() が 0 でない場合にのみ呼び出すことができる。それ以外の状態でこの関数を呼び出すとエラーになります。

enterContainer()、parentContainerType()、containerDepth()も参照 。

quint64 QCborStreamReader::length() const

文字列またはバイト配列の長さ、配列の項目数、またはマップの項目ペアの数を返します（既知の場合）。長さが不明な場合（つまりisLengthKnown() が偽を返した場合）は、この関数を呼んではならない。これはエラーであり、QCborStreamReader が入力ストリームの解析を停止する原因となる。

isLengthKnown()、QCborStreamWriter::startArray()、QCborStreamWriter::startMap()も参照 。

bool QCborStreamReader::next(int maxRecursion = 10000)

CBORストリームのデコードを1要素進める。この関数は通常、固定幅の基本要素（つまり、整数、単純値、タグ、浮動小数点値）をパースするときに呼び出すべきです。しかし、この関数はカレントアイテムが文字列、配列、マップのときにも呼び出すことができ、含まれるすべての要素を含めてその要素全体をスキップします。

この関数は、スキップが成功した場合はtrueを返し、失敗した場合はfalseを返します。ストリームが破損していたり、不完全であったり、配列やマップの入れ子レベルがmaxRecursion を超えていたりすると、失敗することがあります。hasNext() が偽を返したときにこの関数を呼び出すこともエラーとなる。この関数が false を返した場合、lastError() は、失敗の詳細を示すエラー・コードを返します。

lastError()、isValid()、hasNext()も参照 。

QCborStreamReader::Type QCborStreamReader::parentContainerType() const

QCborStreamReader::Array またはQCborStreamReader::Map のいずれかを返します。それぞれ、現在の項目を含むコンテナが配列であったかマップであったかを示します。現在ルート要素をパースしている場合、この関数はQCborStreamReader::Invalid を返します。

containerDepth() およびenterContainer()も参照 。

[since 6.7] QByteArray QCborStreamReader::readAllByteArray()

現在のバイト文字列をデコードして返します。文字列がチャンク化されている場合、この関数はすべてのチャンクを繰り返し処理し、それらを連結します。エラーが発生した場合、この関数はデフォルトで構築された QByteArray() を返しますが、これは特定の空のバイト文字列と区別できない可能性があります。代わりに、lastError （）をチェックして、エラーが発生したかどうかを判断する。

この関数は、整数や文字列からの型変換は行いません。したがって、この関数はisByteArray() が真である場合にのみ呼び出すことができる。

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

readByteArray(),readStringChunk(),isByteArray(),readAllString()も参照 。

[since 6.7] QString QCborStreamReader::readAllString()

現在のテキスト文字列をデコードして返します。文字列がチャンク化されている場合、この関数はすべてのチャンクを繰り返し処理し、それらを連結します。エラーが発生した場合、この関数はデフォルトの QString() を返しますが、これは特定の空のテキスト文字列と区別できない可能性があります。代わりに、lastError() をチェックして、エラーが発生したかどうかを判断します。

この関数は、整数やバイト配列からの型変換は行いません。したがって、この関数を呼び出せるのは、isString （）がtrueを返した場合のみである。それ以外の場合に呼び出すとエラーとなる。

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

readString(),readStringChunk(),isString(),readAllByteArray()も参照 。

[since 6.7] QByteArray QCborStreamReader::readAllUtf8String()

現在のテキスト文字列をデコードして返します。文字列がチャンク化されている場合、この関数はすべてのチャンクを繰り返し処理し、それらを連結します。エラーが発生した場合、この関数はデフォルトの QString() を返しますが、これは特定の空のテキスト文字列と区別できない可能性があります。代わりに、lastError() をチェックして、エラーが発生したかどうかを判断します。

この関数は、整数やバイト配列からの型変換は行いません。したがって、この関数を呼び出せるのは、isString （）がtrueを返した場合のみである。それ以外の場合に呼び出すとエラーとなる。

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

readString(),readStringChunk(),isString(),readAllByteArray()も参照 。

[since 6.7] bool QCborStreamReader::readAndAppendToByteArray(QByteArray &dst)

現在のバイト文字列をデコードし、dst に追加します。 文字列がチャンク化されている場合、この関数はすべてのチャンクを繰り返し処理し、それらを連結します。デコード中にエラーが発生した場合、デコードに成功した他のチャンクがdst に書き込まれる可能性がある。エラーなしでデコードできた場合はtrue を返し、そうでない場合はfalse を返す。

この関数は、整数や文字列からの型変換は行わない。したがって、この関数はisByteArray() が真である場合にのみ呼び出すことができる。

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

readByteArray(),readStringChunk(),isByteArray(),readAndAppendToString()も参照してください 。

[since 6.7] bool QCborStreamReader::readAndAppendToString(QString &dst)

現在のテキスト文字列をデコードし、dst に追加します。 文字列がチャンク化されている場合、この関数はすべてのチャンクを繰り返し処理し、それらを連結します。デコード中にエラーが発生した場合、デコードに成功した他のチャンクがdst に書き込まれる可能性がある。エラーなしでデコードできた場合はtrue を返し、そうでない場合はfalse を返す。

この関数は、整数やバイト配列からの型変換は行わない。したがって、この関数はisString() が真を返した場合にのみ呼び出すことができる。

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

readString(),readStringChunk(),isString(),readAndAppendToByteArray()も参照してください 。

[since 6.7] bool QCborStreamReader::readAndAppendToUtf8String(QByteArray &dst)

現在のテキスト文字列をデコードし、dst に追加します。 文字列がチャンク化されている場合、この関数はすべてのチャンクを繰り返し処理し、それらを連結します。デコード中にエラーが発生した場合、デコードに成功した他のチャンクがdst に書き込まれる可能性がある。エラーなしでデコードできた場合はtrue を返し、そうでない場合はfalse を返す。

この関数は、整数やバイト配列からの型変換は行わない。したがって、この関数はisString() が真を返した場合にのみ呼び出すことができる。

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

readString(),readStringChunk(),isString(),readAndAppendToByteArray()も参照 。

QCborStreamReader::StringResult<QByteArray> QCborStreamReader::readByteArray()

CBOR文字列から1バイトの配列チャンクをデコードして返します。この関数は通常のコンテンツとチャンクされたコンテンツの両方に使用されるため、isLengthKnown() が真であっても、呼び出し元は常にこの関数を呼び出してループしなければならない。この関数の典型的な使い方は以下の通りである：

   QBytearray decodeBytearray(QCborStreamReader &reader)
   {
       QBytearray result;
       auto r = reader.readBytearray();
       while (r.status == QCborStreamReader::Ok) {
           result += r.data;
           r = reader.readByteArray();
       }

       if (r.status == QCborStreamReader::Error) {
           // handle error condition
           result.clear();
       }
       return result;
   }

readAllByteArray() 関数は、上記のループといくつかの追加チェックを実装する。

この関数は、整数や文字列からの型変換は行いません。したがって、この関数はisByteArray() が真である場合にのみ呼び出すことができる。

readAllByteArray(),readString(),isByteArray(),readStringChunk()も参照のこと 。

QCborStreamReader::StringResult<QString> QCborStreamReader::readString()

CBOR文字列から1つの文字列チャンクをデコードして返す。この関数は、通常の文字列コンテンツとチャンクされた文字列コンテンツの両方に使用されるため、isLengthKnown() が真であっても、呼び出し元は常にこの関数を呼び出してループしなければならない。この関数の典型的な使い方は以下のとおりである：

   QString decodeString(QCborStreamReader &reader)
   {
       QString result;
       auto r = reader.readString();
       while (r.status == QCborStreamReader::Ok) {
           result += r.data;
           r = reader.readString();
       }

       if (r.status == QCborStreamReader::Error) {
           // handle error condition
           result.clear();
       }
       return result;
   }

readAllString() 関数は、上記のループといくつかの追加チェックを実装している。

この関数は、整数やバイト配列からの型変換は行いません。したがって、この関数はisString() が真を返した場合にのみ呼び出すことができる。

readAllString()、readByteArray()、isString()、readStringChunk()も参照のこと 。

QCborStreamReader::StringResult<qsizetype> QCborStreamReader::readStringChunk(char *ptr, qsizetype maxlen)

現在の文字列チャンクを、サイズがmaxlen であるptr が指すバッファに読み込みます。この関数はStringResult オブジェクトを返し、ptr にコピーされたバイト数は\l StringResult::data メンバに保存される。\l StringResult::status メンバは、文字列の読み取りにエラーがあったのか、データがコピーされたのか、これが最後のチャンクなのかを示します。

この関数は、String 型とByteArray 型の両方で呼び出すことができる。後者の場合、この関数はreadByteArray() が返したのと同じデータを読み込む。文字列の場合は、QString が返したものと同等の UTF-8 を返します。

この関数は通常、ループ内でcurrentStringChunkSize() と並んで使用される。例えば

    QCborStreamReader<qsizetype> result;
    do {
        qsizetype size = reader.currentStringChunkSize();
        qsizetype oldsize = buffer.size();
        buffer.resize(oldsize + size);
        result = reader.readStringChunk(buffer.data() + oldsize, size);
    } while (result.status() == QCborStreamReader::Ok);

readByteArray() やreadString() と異なり、この関数は、QByteArray やQString の実装制限に制限されることはない。

currentStringChunkSize()、readString()、readByteArray()、isString()、isByteArray()も参照のこと 。

[since 6.7] QCborStreamReader::StringResult<QByteArray> QCborStreamReader::readUtf8String()

CBOR文字列から1つの文字列チャンクをデコードして返す。この関数は、通常の文字列コンテンツとチャンクされた文字列コンテンツの両方に使用されるため、呼び出し側は、isLengthKnown() が真であっても、常にこの関数を呼び出してループしなければならない。この関数の典型的な使用法は、以下のreadString （）と同様である：

   QString decodeString(QCborStreamReader &reader)
   {
       QString result;
       auto r = reader.readString();
       while (r.status == QCborStreamReader::Ok) {
           result += r.data;
           r = reader.readString();
       }

       if (r.status == QCborStreamReader::Error) {
           // handle error condition
           result.clear();
       }
       return result;
   }

readAllUtf8String() 関数は、上記のループといくつかの追加チェックを実装している。

この関数は、整数やバイト配列からの型変換は行いません。したがって、この関数はisString() が真を返した場合のみ呼び出すことができます。それ以外の条件で呼び出すとエラーになります。

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

readAllString(),readByteArray(),isString(),readStringChunk()も参照してください 。

void QCborStreamReader::reparse()

現在の要素を解析し直します。この関数は、CBORストリームの終了前に入力データの終わりに到達したために解析に失敗した後、ソースQIODevice で利用可能なデータが増えたときに呼び出されなければなりません。

QByteArray()から読み出すとき、addData()関数は自動的にこの関数を呼び出す。読み取りが失敗していないときにこの関数を呼び出すことは、ノー・オプションです。

void QCborStreamReader::reset()

ソースを最初にリセットし、デコーダの状態をクリアする。ソース・データがQByteArray であった場合、QCborStreamReader は配列の先頭からリスタートする。

ソース・データがQIODevice の場合、この関数はQIODevice::reset() を呼び出し、バイト位置 0 をシークする。CBOR ストリームがデバイスの先頭で見つからなかった場合（例えば、ファイルの先頭）、この関数は間違った処理を行う可能性が高い。代わりに、QIODevice を正しいオフセットに配置し、setDevice() を呼び出す。

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

void QCborStreamReader::setDevice(QIODevice *device)

データ・ソースをdevice に設定し、デコーダを初期状態にリセットする。

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

bool QCborStreamReader::toBool() const

現在の要素の真偽値を返します。

この関数は、整数からの型変換を含め、いかなる型変換も行いません。したがって、isTrue()、isFalse()、isBool() が真を返した場合にのみ呼び出すことができる。それ以外の条件で呼び出すとエラーとなる。

isBool()、isTrue()、isFalse()、toInteger()も参照 。

double QCborStreamReader::toDouble() const

現在の要素の 64 ビット倍精度浮動小数点値を返します。

この関数は、他の浮動小数点型や整数値からの型変換は行いません。したがって、この関数はisDouble() が真である場合にのみ呼び出すことができます。

isDouble(),toFloat16(),toFloat()も参照 。

qfloat16 QCborStreamReader::toFloat16() const

現在の要素の 16 ビット半精度浮動小数点値を返します。

この関数は、他の浮動小数点型や整数値からの型変換は行いません。したがって、この関数は、isFloat16() が真である場合にのみ呼び出すことができます。それ以外の条件で呼び出すとエラーになります。

isFloat16(),toFloat(),toDouble()も参照 。

float QCborStreamReader::toFloat() const

現在の要素の 32 ビット単精度浮動小数点値を返します。

この関数は、他の浮動小数点型や整数値からの型変換は行いません。したがって、この関数を呼び出すことができるのは、isFloat() が真である場合だけです。

isFloat()、toFloat16()、toDouble()も参照 。

qint64 QCborStreamReader::toInteger() const

現在の要素の整数値（負、正、ゼロのいずれか）を返します。値が²⁶³- 1 より大きいか^-263 より小さい場合、返される値はオーバーフローし、符号が不正確になります。これらの値の処理が必要な場合は、代わりにtoUnsignedInteger() またはtoNegativeInteger() を使用する。

この関数は、boolean や CBOR タグからの型変換を含め、いかなる型変換も行わない。したがって、この関数はisInteger() が真である場合にのみ呼び出すことができる。

isInteger(),toUnsignedInteger(),toNegativeInteger()も参照 。

QCborNegativeInteger QCborStreamReader::toNegativeInteger() const

現在の要素の負の整数値を返します。QCborNegativeValueは、CBORストリームに格納された負の数の絶対値を含む64ビットの符号なし整数です。さらに、QCborNegativeValue(0)は数値^-264を表します。

この関数は、boolean または CBOR タグからの型変換を含め、いかなる型変換も行いません。従って、isNegativeInteger()がtrueの場合のみ呼び出すことができる。それ以外の条件で呼び出すとエラーとなる。

この関数は、toInteger （）の戻り値の型の範囲を超える数値を得るために使用で きる。ただし、^-263 よりも小さい負数の使用は極端に推奨されない。

type()、toInteger()、isNegativeInteger()、isUnsignedInteger()も参照のこと 。

QCborSimpleType QCborStreamReader::toSimpleType() const

現在の単純型の値を返す。

この関数は、整数からの変換を含め、いかなる型変換も行わない。したがって、isSimpleType() が真である場合にのみ呼び出すことができます。それ以外の条件で呼び出すとエラーになります。

isSimpleType()、isTrue()、isFalse()、isBool()、isNull()、isUndefined()も参照 。

QCborTag QCborStreamReader::toTag() const

現在の要素のタグ値を返します。

この関数は、整数からの型変換を含め、いかなる型変換も行いません。したがって、isTag() が真である場合にのみ呼び出すことができます。それ以外の条件で呼び出すとエラーになります。

タグは、汎用のCBOR型に付加された64ビットの数値であり、それらに更なる意味を与える。既知のタグのリストについては、QCborKnownTags 列挙を参照のこと。

isTag()、toInteger()、QCborKnownTagsも参照のこと 。

quint64 QCborStreamReader::toUnsignedInteger() const

現在の要素の符号なし整数値を返す。

この関数は、boolean または CBOR タグからの型変換を含め、いかなる型変換も行いません。したがって、この関数はisUnsignedInteger() が真である場合にのみ呼び出すことができる。

この関数は、toInteger() の戻り値の型の範囲を超える数値を得るために使用できる。

type()、toInteger()、isUnsignedInteger()、isNegativeInteger()も参照 。

QCborStreamReader::Type QCborStreamReader::type() const

現在の要素の型を返します。有効な型のいずれか、または Invalid です。

isValid(),isUnsignedInteger(),isNegativeInteger(),isInteger(),isByteArray(),isString(),isArray(),isMap(),isTag(),isSimpleType(),isBool(),isFalse(),isTrue(),isNull(),isUndefined(),isFloat16(),isFloat(),isDouble()も 参照。