QCborValue Class

Dokumentation zu den Member-Funktionen

QCborValue::QCborValue()

Erstellt einen QCborValue vom Typ „ Undefined “.

Undefinierte CBOR-Werte werden verwendet, um fehlende Informationen anzuzeigen, die in der Regel auf eine vorherige Operation zurückzuführen sind, die nicht wie erwartet abgeschlossen wurde. Sie werden außerdem von den APIs „ QCborArray “ und „ QCborMap “ verwendet, um anzuzeigen, dass das gesuchte Element nicht gefunden wurde.

Undefinierte Werte werden durch „ Undefined simple type “ dargestellt. Aus diesem Grund geben „QCborValues“ mit undefinierten Werten auch bei den Methoden „ isSimpleType()“ und „ isSimpleType(QCborSimpleType::Undefined) “ den Wert „true“ zurück.

Undefinierte Werte unterscheiden sich von Nullwerten.

QCborValue-Objekte mit undefinierten Werten unterscheiden sich zudem von ungültigen QCborValue-Objekten. Die API erzeugt keine ungültigen QCborValues, diese können jedoch als Folge eines Parsing-Fehlers auftreten.

Siehe auch „ isUndefined()“, „ isNull()“ und „ isSimpleType()“.

Erstellt ein „ QCborValue “ mit dem Array „ a “. Das Array kann später mit „ toArray()“ abgerufen werden.

Siehe auch toArray(), isArray() und isMap().

Erstellt eine „ QCborValue “ mit der Karte „ m “. Die Karte kann später mit „ toMap()“ abgerufen werden.

Siehe auch toMap(), isMap() und isArray().

QCborValue::QCborValue(QCborSimpleType st)

Erzeugt einen QCborValue vom einfachen Typ „ st “. Der Typ kann später sowohl mit „ toSimpleType()“ als auch mit „ isSimpleType(st)“ abgerufen werden.

Einfache CBOR-Typen sind Typen, denen kein Wert zugeordnet ist, wie beispielsweise der C++-Typ ` std::nullptr_t `, dessen einzig möglicher Wert ` nullptr` ist.

Ist st gleich QCborSimpleType::Null, so ist der resultierende QCborValue vom Typ Null; dasselbe gilt für QCborSimpleType::Undefined. Ist st gleich QCborSimpleType::False oder QCborSimpleType::True, so ist der erstellte QCborValue ein boolescher Wert, der jeweils den Wert „false“ oder „true“ enthält.

Diese Funktion kann mit einfachen Typen verwendet werden, die nicht in der API definiert sind. Um beispielsweise einen `QCborValue` mit dem einfachen Typ 12 zu erstellen, könnte man schreiben:

QCborValue value(QCborSimpleType(12));

Einfache Typen sollten erst verwendet werden, wenn eine Spezifikation dafür veröffentlicht wurde, da andere Implementierungen diese möglicherweise nicht ordnungsgemäß unterstützen. Die Werte 24 bis 31 für einfache Typen sind reserviert und dürfen nicht verwendet werden.

isSimpleType(), isNull(), isUndefined(), isTrue(), isFalse()

QCborValue::QCborValue(QCborValue::Type t_)

Erstellt einen QCborValue vom Typ „ t_ “. Der diesem Typ zugeordnete Wert (sofern vorhanden) wird standardmäßig initialisiert.

Siehe auch ` type()`.

QCborValue::QCborValue(QStringView s)

Erstellt einen QCborValue mit dem Zeichenfolgenwert „ s “. Der Wert kann später mit der Funktion „ toString()“ abgerufen werden.

Siehe auch toString(), isString() und isByteArray().

QCborValue::QCborValue(bool b)

Erzeugt einen QCborValue mit dem booleschen Wert „ b “. Der Wert kann später mit der Funktion „ toBool()“ abgerufen werden.

Intern werden CBOR-Boolesche Werte durch ein Typenpaar dargestellt, wobei ein Typ für „true“ und der andere für „false“ steht. Aus diesem Grund geben boolesche QCborValues bei Aufruf von „ isSimpleType()“ den Wert „true“ zurück und bei Aufruf von „ isSimpleType(QCborSimpleType::False) “ oder „ isSimpleType(QCborSimpleType::True) “ einen der entsprechenden Werte.

Siehe auch „ toBool()“, „ isBool()“, „ isTrue()“, „ isFalse()“ und „ isSimpleType()“.

QCborValue::QCborValue(const QByteArray &ba)

Erzeugt einen QCborValue mit dem Byte-Array-Wert „ ba “. Der Wert kann später mit der Funktion „ toByteArray()“ abgerufen werden.

Siehe auch toByteArray(), isByteArray() und isString().

[explicit] QCborValue::QCborValue(const QDateTime &dt)

Erstellt ein QCborValue-Objekt vom erweiterten Datums-/Uhrzeit-Typ, das den durch dt dargestellten Wert enthält. Der Wert kann später mit toDateTime() abgerufen werden.

Die CBOR-Datums-/Uhrzeittypen sind Erweiterungstypen, die Tags verwenden: entweder eine Zeichenkette (im ISO-Datumsformat), die als „ DateTime “ gekennzeichnet ist, oder eine Zahl (in Sekunden seit Beginn des Jahres 1970, UTC), die als „ UnixTime_t “ gekennzeichnet ist. Beim Parsen von CBOR-Strömen konvertiert „QCborValue“ „ UnixTime_t “ in den zeichenfolgenbasierten Typ.

Siehe auch toDateTime(), isDateTime() und taggedValue().

[explicit] QCborValue::QCborValue(const QRegularExpression &rx)

Erstellt ein QCborValue-Objekt vom erweiterten Typ „Regulärer Ausdruck“, das den durch rx dargestellten Wert enthält. Der Wert kann später mit toRegularExpression() abgerufen werden.

Der CBOR-Typ für reguläre Ausdrücke ist ein erweiterter Typ, der durch eine als „ RegularExpression “ gekennzeichnete Zeichenkette dargestellt wird. Beachten Sie, dass CBOR-reguläre Ausdrücke nur die Muster speichern, sodass alle Flags, die das QRegularExpression -Objekt möglicherweise enthält, verloren gehen.

Siehe auch toRegularExpression(), isRegularExpression() und taggedValue().

QCborValue::QCborValue(const QString &s)

Erstellt einen QCborValue mit dem Zeichenfolgenwert „ s “. Der Wert kann später mit der Funktion „ toString()“ abgerufen werden.

Siehe auch toString(), isString() und isByteArray().

[explicit] QCborValue::QCborValue(const QUrl &url)

Erstellt ein QCborValue-Objekt vom erweiterten Typ „URL“, das den durch url dargestellten Wert enthält. Der Wert kann später mit toUrl() abgerufen werden.

Der CBOR-URL-Typ ist ein erweiterter Typ, der durch eine als „ Url “ gekennzeichnete Zeichenkette dargestellt wird.

Siehe auch toUrl(), isUrl() und taggedValue().

[explicit] QCborValue::QCborValue(const QUuid &uuid)

Erstellt ein QCborValue-Objekt vom erweiterten Typ „UUID“, das den durch uuid dargestellten Wert enthält. Der Wert kann später mit toUuid() abgerufen werden.

Der CBOR-UUID-Typ ist ein erweiterter Typ, der durch ein Byte-Array dargestellt wird, das als „ Uuid “ gekennzeichnet ist.

Siehe auch toUuid(), isUuid() und taggedValue().

[delete] QCborValue::QCborValue(const void *)

Erstellt standardmäßig eine Instanz von ` QCborValue`. Diese Funktion wurde gelöscht.

QCborValue::QCborValue(double d)

Erzeugt ein QCborValue-Objekt mit dem Gleitkommawert „ d “. Der Wert kann später mit der Funktion „ toDouble()“ abgerufen werden.

CBOR-Gleitkommawerte unterscheiden sich von Ganzzahlwerten. Daher werden „QCborValue“-Objekte mit Ganzzahlen anders verglichen als „QCborValue“-Objekte, die Gleitkommawerte enthalten, selbst wenn die in den Objekten enthaltenen Werte gleich sind.

Siehe auch toDouble(), isDouble() und isInteger().

QCborValue::QCborValue(qint64 i)

Erzeugt ein QCborValue-Objekt mit dem ganzzahligen Wert „ i “. Der Wert kann später mit der Funktion „ toInteger()“ abgerufen werden.

CBOR-Ganzzahlwerte unterscheiden sich von Gleitkommawerten. Daher werden „QCborValue“-Objekte mit Ganzzahlen anders verglichen als „QCborValue“-Objekte, die Gleitkommawerte enthalten, selbst wenn die in den Objekten enthaltenen Werte gleichwertig sind.

Siehe auch toInteger(), isInteger() und isDouble().

QCborValue::QCborValue(std::nullptr_t)

Erstellt einen QCborValue vom Typ „ Null “.

CBOR-Nullwerte werden verwendet, um optionale Werte zu kennzeichnen, die nicht angegeben wurden. Sie unterscheiden sich von undefinierten Werten dadurch, dass Nullwerte in der Regel nicht das Ergebnis eines früheren Fehlers oder Problems sind.

Siehe auch „ isNull()“, „ isUndefined()“ und „ isSimpleType()“.

Erstellt einen „ QCborValue “ für den erweiterten Typ, der durch den Tag-Wert „ tag “ und den Tag-Wert „ tv “ dargestellt wird. Der Tag kann später mit „ tag()“ abgerufen werden, der mit dem Tag versehene Wert mit „ taggedValue()“.

Siehe auch isTag(), tag(), taggedValue() und QCborKnownTags.

QCborValue::QCborValue(QLatin1StringView s)

Erzeugt einen QCborValue mit der Latin-1-Zeichenkette, die von ` s` ausgewertet wird. Der Wert kann später mit ` toString()` abgerufen werden.

Siehe auch toString(), isString() und isByteArray().

[noexcept] QCborValue::QCborValue(const QCborValue &other)

Kopiert den Inhalt von „ other “ in dieses Objekt.

[noexcept] QCborValue::QCborValue(QCborValue &&other)

Überträgt den Inhalt des QCborValue-Objekts „ other “ in dieses Objekt und gibt die Ressourcen dieses Objekts frei.

[noexcept] QCborValue::~QCborValue()

Entfernt das aktuelle „ QCborValue “-Objekt und gibt alle damit verbundenen Ressourcen frei.

int QCborValue::compare(const QCborValue &other) const

Vergleicht diesen Wert mit other und gibt eine Ganzzahl zurück, die angibt, ob dieser Wert vor (bei negativem Ergebnis) oder nach other (bei positivem Ergebnis) sortiert werden soll. Wenn diese Funktion 0 zurückgibt, sind die beiden Werte gleich und haben denselben Inhalt.

Enthält jeder Wert von ` QCborValue ` ein Array oder eine Map, erfolgt der Vergleich rekursiv auf die darin enthaltenen Elemente.

Erweiterte Typen

QCborValue vergleicht „ QCborValue “, die einen erweiterten Typ enthalten, wie z. B. „ Url “ und „ Url “, sowie deren äquivalente getaggte Darstellung als gleich. So ist beispielsweise der folgende Ausdruck wahr:

QCborValue(QUrl("https://example.com")) == QCborValue(QCborKnownTags::Url, "https://example.com");

Beachten Sie, dass Qt-Typen wie ` QUrl ` und ` QDateTime ` ihre Argumente normalisieren und anderweitig modifizieren. Der obige Ausdruck ist nur deshalb wahr, weil die Zeichenkette auf der rechten Seite der normalisierte Wert ist, den der ` QCborValue ` auf der linken Seite annehmen würde. Wäre beispielsweise der Teil „https“ auf beiden Seiten in Großbuchstaben geschrieben, würde der Vergleich fehlschlagen. Informationen zu den von QCborValue durchgeführten Normalisierungen finden Sie in der Dokumentation des Konstruktors, der den betreffenden Qt-Typ verwendet.

Sortierreihenfolge

Die Sortierreihenfolge in CBOR ist in RFC 7049, Abschnitt 3.9, definiert, in dem die Sortierung von Schlüsseln in einem Map unter Verwendung der kanonischen Kodierung behandelt wird. Gemäß der Spezifikation „erfolgt die Sortierung anhand der Bytes der Darstellung der Schlüsseldatenelemente“ und als Konsequenzen wird Folgendes aufgeführt:

• „Wenn zwei Schlüssel unterschiedliche Längen haben, wird der kürzere früher sortiert;“
• „Wenn zwei Schlüssel dieselbe Länge haben, wird derjenige mit dem niedrigeren Wert in (byteweiser) lexikalischer Reihenfolge früher sortiert.“

Dies führt zu einer überraschenden Sortierung von `QCborValues`, bei der das Ergebnis dieser Funktion von dem abweicht, das später durch den Vergleich der enthaltenen Elemente ermittelt würde. Beispielsweise wird der „ QCborValue “ mit der Zeichenkette „zzz“ vor dem „ QCborValue “ mit der Zeichenkette „foobar“ sortiert, obwohl beim Vergleich als „ QStrings “ oder „ QByteArrays “ das „zzz“ nach dem „foobar“ sortiert wird (in Wörterbuchreihenfolge).

Die Spezifikation gibt nicht eindeutig an, welche Sortierreihenfolge für Werte unterschiedlicher Typen gelten soll (es heißt dort, dass bei der Sortierung die „3/5-Bit-Aufteilung für Haupttypen nicht berücksichtigt werden sollte“). QCborValue geht davon aus, dass auch Typen sortiert werden sollten. Die numerischen Werte der Aufzählung ` QCborValue::Type ` sind in dieser Reihenfolge angeordnet, mit Ausnahme der erweiterten Typen, die wie ihre getaggten Entsprechungen verglichen werden.

Siehe auch QCborArray::compare(), QCborMap::compare() und operator==().

[static] QCborValue QCborValue::fromCbor(QCborStreamReader &reader)

Dekodiert ein Element aus dem CBOR-Stream, der unter reader zu finden ist, und gibt die entsprechende Darstellung zurück. Diese Funktion ist rekursiv: Handelt es sich bei dem Element um eine Map oder ein Array, werden alle darin enthaltenen Elemente dekodiert, bis das oberste Objekt vollständig verarbeitet ist.

Diese Funktion muss nicht auf das Wurzelelement eines ` QCborStreamReader` angewendet werden. Der folgende Code veranschaulicht beispielsweise, wie das CBOR-Signatur-Tag am Anfang einer Datei übersprungen werden kann:

if (reader.isTag() && reader.toTag() == QCborKnownTags::Signature)
    reader.next();

QCborValue contents = QCborValue::fromCbor(reader);

Der zurückgegebene Wert kann teilweise vollständig sein und sich nicht von einem gültigen „ QCborValue “ unterscheiden, selbst wenn die Dekodierung fehlgeschlagen ist. Um festzustellen, ob ein Fehler aufgetreten ist, prüfen Sie, ob „ reader.lastError()“ einen Fehlerzustand anzeigt. Diese Funktion bricht die Dekodierung unmittelbar nach dem ersten Fehler ab.

Siehe auch toCbor(), toDiagnosticNotation(), toVariant() und toJsonValue().

[static] QCborValue QCborValue::fromCbor(const QByteArray &ba, QCborParserError *error = nullptr)

Dekodiert ein Element aus dem CBOR-Stream, der sich im Byte-Array ` ba ` befindet, und gibt die entsprechende Darstellung zurück. Diese Funktion ist rekursiv: Handelt es sich bei dem Element um eine Map oder ein Array, werden alle darin enthaltenen Elemente dekodiert, bis das oberste Objekt vollständig verarbeitet ist.

Diese Funktion speichert den eventuellen Fehlerstatus in dem Objekt, auf das error verweist, zusammen mit dem Offset der Stelle, an der der Fehler aufgetreten ist. Wenn kein Fehler aufgetreten ist, speichert sie NoError im Fehlerstatus und die Anzahl der verbrauchten Bytes (d. h., sie speichert den Offset für das erste ungenutzte Byte). Anhand dieser Informationen ist es möglich, weitere Daten zu analysieren, die möglicherweise im selben Byte-Array vorhanden sind.

Der Rückgabewert kann teilweise vollständig sein und sich nicht von einem gültigen ` QCborValue ` unterscheiden, selbst wenn die Dekodierung fehlgeschlagen ist. Um festzustellen, ob ein Fehler aufgetreten ist, prüfen Sie, ob in ` error` ein Fehler gespeichert wurde. Diese Funktion bricht die Dekodierung unmittelbar nach dem ersten Fehler ab.

Siehe auch ` toCbor()`, ` toDiagnosticNotation()`, ` toVariant()` und ` toJsonValue()`.

Konvertiert „ len “ Bytes von „ data “ in ein „ QByteArray “ und ruft anschließend die Überladung dieser Funktion auf, die ein „ QByteArray “ akzeptiert, wobei zusätzlich „ error “ übergeben wird, sofern vorhanden.

[static] QCborValue QCborValue::fromJsonValue(const QJsonValue &v)

Konvertiert den in v enthaltenen JSON-Wert in den entsprechenden CBOR-Wert und gibt diesen zurück. Bei der Konvertierung von JSON nach CBOR geht kein Datenverlust auf, da die CBOR-Typenmenge umfangreicher ist als die von JSON. Zudem können Werte, die mit dieser Funktion in CBOR konvertiert wurden, mit toJsonValue() ohne Datenverlust wieder in JSON zurückkonvertiert werden.

Die folgende Tabelle listet die Zuordnung von JSON-Typen zu CBOR-Typen auf:

QJsonValue kann auch undefiniert sein, was auf eine zuvor fehlgeschlagene Operation hinweist (z. B. die Suche nach einem Schlüssel, der in einem Objekt nicht vorhanden ist). Undefinierte Werte sind keine JSON-Typen und dürfen in JSON-Arrays und -Objekten nicht vorkommen, doch diese Funktion gibt den undefinierten Wert „ QCborValue “ zurück, wenn der entsprechende „ QJsonValue “ undefiniert ist.

Siehe auch toJsonValue(), fromVariant(), QCborArray::fromJsonArray() und QCborMap::fromJsonObject().

[static] QCborValue QCborValue::fromVariant(const QVariant &variant)

Konvertiert das „ QVariant “ variant in „ QCborValue “ und gibt es zurück.

QVariants können eine umfangreiche Liste verschiedener Metatypen enthalten, von denen viele keine entsprechende Darstellung in CBOR haben. Dazu gehören alle benutzerdefinierten Metatypen. Bei der Vorbereitung der Übertragung mit CBOR wird empfohlen, jeden Wert sorgfältig zu kodieren, um einen Darstellungsverlust zu vermeiden.

Die folgende Tabelle listet die Konvertierungen auf, die diese Funktion anwendet:

Wenn ` QVariant::isNull()` „true“ zurückgibt, wird ein Null- QCborValue zurückgegeben oder in die Liste bzw. das Objekt eingefügt, unabhängig vom Typ, den ` QVariant` übergibt. Beachten Sie, dass die Verhaltensänderung in Qt 6.0, die sich auf ` QVariant::isNull()` auswirkt, auch diese Funktion betrifft.

Bei anderen, oben nicht aufgeführten Typen wird eine Konvertierung in einen String versucht, in der Regel – aber nicht immer – durch Aufruf von ` QVariant::toString()`. Schlägt die Konvertierung fehl, wird der Wert durch einen undefinierten CBOR-Wert ersetzt. Beachten Sie, dass ` QVariant::toString()` bei den meisten Typen ebenfalls zu Datenverlusten führt.

Bitte beachten Sie, dass sich die Konvertierungen über ` QVariant::toString()` jederzeit ändern können. Sowohl ` QVariant ` als auch ` QCborValue ` können in Zukunft erweitert werden, um weitere Typen zu unterstützen, was zu einer Änderung der Art und Weise führen wird, wie diese Funktion Konvertierungen durchführt.

Siehe auch toVariant(), fromJsonValue(), QCborArray::toVariantList(), QCborMap::toVariantMap() und QJsonValue::fromVariant().

bool QCborValue::isArray() const

Gibt „true“ zurück, wenn dieses QCborValue vom Typ „Array“ ist. Der Array-Wert kann mit toArray() abgerufen werden.

Siehe auch „ type()“ und „ toArray()“.

bool QCborValue::isBool() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ ein boolescher Wert ist. Der Wert kann mit „ toBool()“ abgerufen werden.

Siehe auch „ type()“, „ toBool()“, „ isTrue()“ und „ isFalse()“.

bool QCborValue::isByteArray() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „Byte-Array“ ist. Der Wert des Byte-Arrays kann mit „ toByteArray()“ abgerufen werden.

Siehe auch type() und toByteArray().

bool QCborValue::isContainer() const

Diese Hilfsfunktion gibt „true“ zurück, wenn „ QCborValue “ entweder ein Array oder ein Map ist.

Siehe auch „ isArray()“ und „ isMap()“.

bool QCborValue::isDateTime() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „Datum/Uhrzeit“ ist. Der Wert kann mit „ toDateTime()“ abgerufen werden. Datums- und Zeitangaben sind erweiterte Typen, die das Tag „ DateTime “ verwenden.

Zudem interpretiert „ QCborValue “ beim Dekodieren aus einem CBOR-Stream Tags mit dem Wert „ UnixTime_t “ und konvertiert sie in das entsprechende Datum/die entsprechende Uhrzeit.

Siehe auch type() und toDateTime().

bool QCborValue::isDouble() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „floating-point“ ist. Der Wert kann mit „ toDouble()“ abgerufen werden.

Siehe auch type() und toDouble().

bool QCborValue::isFalse() const

Gibt „true“ zurück, wenn dieser „ QCborValue “ ein Boolescher Wert mit dem Wert „false“ ist. Diese Funktion existiert, weil Boolesche Werte in CBOR intern als zwei separate Typen gespeichert werden, einer für „true“ und einer für „false“.

Siehe auch „ type()“, „ isBool()“, „ isTrue()“ und „ toBool()“.

bool QCborValue::isInteger() const

Gibt „true“ zurück, wenn diese „ QCborValue “ vom Typ „integer“ ist. Der Integer-Wert kann mit „ toInteger()“ abgerufen werden.

Siehe auch type() und toInteger().

bool QCborValue::isInvalid() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ keinem gültigen Typ entspricht. Ungültige „QCborValues“ unterscheiden sich von solchen mit undefinierten Werten und weisen in der Regel auf einen Dekodierungsfehler hin.

Siehe auch „ isUndefined()“ und „ isNull()“.

bool QCborValue::isMap() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „Map“ ist. Der Wert der Map kann mit „ toMap()“ abgerufen werden.

Siehe auch ` type()` und ` toMap()`.

bool QCborValue::isNull() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „null“ ist.

CBOR-Nullwerte werden verwendet, um optionale Werte zu kennzeichnen, die nicht angegeben wurden. Sie unterscheiden sich von undefinierten Werten darin, dass Nullwerte in der Regel nicht das Ergebnis eines früheren Fehlers oder Problems sind.

Null-Werte unterscheiden sich sowohl von undefinierten Werten als auch von ungültigen „ QCborValue “-Objekten. Die API erzeugt keine ungültigen „QCborValues“, diese können jedoch als Folge eines Parsing-Fehlers auftreten.

Siehe auch „ type()“, „ isUndefined()“ und „ isInvalid()“.

bool QCborValue::isRegularExpression() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ ein Muster eines regulären Ausdrucks enthält. Das Muster kann mit „ toRegularExpression()“ abgerufen werden.

Siehe auch type() und toRegularExpression().

bool QCborValue::isSimpleType() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ einem der einfachen CBOR-Typen entspricht. Der Typ selbst kann später mit „ type()“ abgerufen werden, selbst bei Typen, für die in der API keine Aufzählung vorhanden ist. Sie können auch mit der Überladung von „ isSimpleType “ (QCborSimpleType) überprüft werden.

Siehe auch QCborSimpleType, isSimpleType(QCborSimpleType) und toSimpleType().

bool QCborValue::isSimpleType(QCborSimpleType st) const

Gibt „true“ zurück, wenn dieses QCborValue vom Typ „einfacher Typ“ ist und toSimpleType() den Wert st zurückgeben würde; andernfalls „false“. Diese Funktion kann verwendet werden, um jeden einfachen CBOR-Typ zu überprüfen, auch solche, für die es in der API keine Aufzählung gibt. Für den einfachen Typ mit dem Wert 12 könnten Sie beispielsweise Folgendes schreiben:

value.isSimpleType(QCborSimpleType(12));

Siehe auch QCborValue::QCborValue(QCborSimpleType), isSimpleType(), isFalse(), isTrue(), isNull, isUndefined() und toSimpleType().

bool QCborValue::isString() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „string“ ist. Der String-Wert kann mit „ toString()“ abgerufen werden.

Siehe auch type() und toString().

bool QCborValue::isTag() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „Tag“ ist. Der Tag-Wert kann mit „ tag()“ und der mit dem Tag versehene Wert mit „ taggedValue()“ abgerufen werden.

Diese Funktion gibt auch für erweiterte Typen, die die API erkennt, „true“ zurück. Für Code, der erweiterte Typen direkt verarbeitet, bevor die Qt-API aktualisiert wird, um diese zu unterstützen, ist es möglich, das Paar aus Tag und Tag-Wert mithilfe von ` taggedValue()` neu zu erstellen.

Siehe auch type(), tag() und taggedValue().

bool QCborValue::isTrue() const

Gibt „true“ zurück, wenn dieser „ QCborValue “ ein Boolescher Wert mit dem Wert „true“ ist. Diese Funktion existiert, da Boolesche Werte in CBOR intern als zwei separate Typen gespeichert werden: einer für „false“ und einer für „true“.

Siehe auch „ type()“, „ isBool()“, „ isFalse()“ und „ toBool()“.

bool QCborValue::isUndefined() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „undefined“ ist.

Undefinierte Werte in CBOR werden verwendet, um fehlende Informationen anzuzeigen, die in der Regel auf eine vorherige Operation zurückzuführen sind, die nicht wie erwartet abgeschlossen wurde. Sie werden außerdem von den APIs „ QCborArray “ und „ QCborMap “ verwendet, um anzuzeigen, dass das gesuchte Element nicht gefunden wurde.

Undefinierte Werte unterscheiden sich von Nullwerten.

QCborValue Objekte mit undefinierten Werten unterscheiden sich zudem von ungültigen QCborValue -Objekten. Die API erzeugt keine ungültigen QCborValues, diese können jedoch infolge eines Parsing-Fehlers auftreten.

Siehe auch type(), isNull() und isInvalid().

bool QCborValue::isUrl() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ vom Typ „URL“ ist. Der URL-Wert kann mit „ toUrl()“ abgerufen werden.

Siehe auch type() und toUrl().

bool QCborValue::isUuid() const

Gibt „true“ zurück, wenn dieses „ QCborValue “ eine UUID enthält. Der Wert kann mit „ toUuid()“ abgerufen werden.

Siehe auch type() und toUuid().

[noexcept] void QCborValue::swap(QCborValue &other)

Tauscht diesen Wert mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QCborTag QCborValue::tag(QCborTag defaultValue = QCborTag(-1)) const

Gibt das Tag dieses erweiterten „ QCborValue “-Objekts zurück, sofern es vom Typ „tag“ ist, andernfalls „ defaultValue “.

CBOR stellt erweiterte Typen dar, indem es eine Zahl (das Tag) mit einer gespeicherten Darstellung verknüpft. Diese Funktion gibt diese Zahl zurück. Um die Darstellung abzurufen, verwenden Sie ` taggedValue()`.

Siehe auch „ isTag()“, „ taggedValue()“, „ isDateTime()“, „ isUrl()“, „ isRegularExpression()“ und „ isUuid()“.

QCborValue QCborValue::taggedValue(const QCborValue &defaultValue = QCborValue()) const

Gibt den mit einem Tag versehenen Wert dieses erweiterten „ QCborValue “-Objekts zurück, sofern es vom Typ „tag“ ist; andernfalls „ defaultValue “.

CBOR stellt erweiterte Typen dar, indem es eine Zahl (das Tag) mit einer gespeicherten Darstellung verknüpft. Diese Funktion gibt diese Darstellung zurück. Um das Tag abzurufen, verwenden Sie „ tag()“.

Siehe auch „ isTag()“, „ tag()“, „ isDateTime()“, „ isUrl()“, „ isRegularExpression()“ und „ isUuid()“.

Gibt den in diesem ` QCborValue` gespeicherten Array-Wert zurück, sofern dieser vom Typ Array ist. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in ` QCborArray` durchführt.

Siehe auch „ isArray()“, „ isByteArray()“, „ isMap()“, „ isContainer()“ und „ toMap()“.

bool QCborValue::toBool(bool defaultValue = false) const

Gibt den in diesem „ QCborValue “ gespeicherten booleschen Wert zurück, sofern dieser vom Typ „Boolean“ ist. Andernfalls wird „ defaultValue “ zurückgegeben.

Siehe auch „ isBool()“, „ isTrue()“ und „ isFalse()“.

QByteArray QCborValue::toByteArray(const QByteArray &defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten Byte-Array-Wert zurück, sofern dieser vom Typ „Byte-Array“ ist. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in ` QByteArray` durchführt.

Siehe auch isByteArray(), isString() und toString().

QByteArray QCborValue::toCbor(QCborValue::EncodingOptions opt = NoTransformation) const

Kodiert dieses QCborValue -Objekt unter Verwendung der unter opt angegebenen Optionen in seine CBOR-Darstellung und gibt das Byte-Array zurück, das diese Darstellung enthält.

Diese Funktion schlägt nur dann fehl, wenn dieses ` QCborValue ` oder eines der darin enthaltenen Elemente – sofern es sich um eine Map oder ein Array handelt – ungültig ist. Ungültige Typen werden von der API normalerweise nicht erzeugt, können jedoch durch Dekodierungsfehler entstehen.

Standardmäßig führt diese Funktion keine Transformation der Werte in ` QCborValue` durch und schreibt alle Gleitkommazahlen direkt als Doppelpräzisionswerte (double) . Wenn die Option ` UseFloat ` angegeben ist, wird für alle Gleitkommazahlen, bei denen bei Verwendung dieser Darstellung kein Präzisionsverlust auftritt, Einzelpräzision (float) verwendet. Dies schließt Unendlichkeits- und NaN-Werte ein.

Ähnlich verhält es sich, wenn „ UseFloat16 “ angegeben ist: Diese Funktion versucht, Gleitkommazahlen mit halber Genauigkeit (qfloat16) zu verwenden, sofern die Umwandlung in diese Form keinen Genauigkeitsverlust zur Folge hat. Dies gilt immer für Unendlichkeitswerte und NaN-Werte.

Wird ` UseIntegers ` angegeben, werden für jeden Gleitkommawert, der eine tatsächliche Ganzzahl enthält, Ganzzahlen verwendet.

Siehe auch fromCbor(), fromVariant() und fromJsonValue().

void QCborValue::toCbor(QCborStreamWriter &writer, QCborValue::EncodingOptions opt = NoTransformation) const

Kodiert dieses QCborValue -Objekt unter Verwendung der in opt angegebenen Optionen in seine CBOR-Darstellung und überträgt es an den durch writer angegebenen Writer. Ein und derselbe Writer kann von mehreren QCborValues verwendet werden, beispielsweise um verschiedene Elemente eines größeren Arrays zu kodieren.

Diese Funktion schlägt nur dann fehl, wenn dieses ` QCborValue ` oder eines der darin enthaltenen Elemente – sofern es sich um eine Map oder ein Array handelt – ungültig ist. Ungültige Typen werden von der API normalerweise nicht erzeugt, können jedoch durch Dekodierungsfehler entstehen.

Standardmäßig führt diese Funktion keine Transformation der Werte in der ` QCborValue` durch und schreibt alle Gleitkommazahlen direkt als Typen mit doppelter Genauigkeit (binary64). Wenn die Option ` UseFloat ` angegeben ist, wird für jeden Gleitkommawert, bei dem bei Verwendung dieser Darstellung kein Präzisionsverlust auftritt, einfache Genauigkeit (binary32) verwendet. Dies schließt Unendlichkeitswerte und NaN-Werte ein.

Ebenso versucht diese Funktion bei Angabe von „ UseFloat16 “, Gleitkommazahlen mit halber Genauigkeit (binary16) zu verwenden, sofern die Umwandlung in diesen Typ zu keinem Genauigkeitsverlust führt. Dies gilt stets für Unendlichkeiten und NaN-Werte.

Wird „ UseIntegers “ angegeben, werden für jeden Gleitkommawert, der eine tatsächliche Ganzzahl enthält, Ganzzahlen verwendet.

Siehe auch „ fromCbor()“, „ fromVariant()“ und „ fromJsonValue()“.

QDateTime QCborValue::toDateTime(const QDateTime &defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten Datums-/Zeitwert zurück, sofern es sich um den erweiterten Datums-/Zeittyp handelt. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in „ QDateTime “ durchführt.

Siehe auch „ isDateTime()“, „ isTag()“ und „ taggedValue()“.

QString QCborValue::toDiagnosticNotation(QCborValue::DiagnosticNotationOptions opts = Compact) const

Erzeugt das dieser CBOR-Objekt entsprechende Objekt in der Diagnosenotation und gibt es zurück. Der Parameter „ opts “ steuert den Dialekt der Notation. Die Diagnosekonvention ist beim Debuggen nützlich, um dem Entwickler zu verdeutlichen, welcher Wert im „ QCborValue “ oder in einem CBOR-Stream gespeichert ist. Aus diesem Grund bietet die Qt-API keine Unterstützung für das Zurückparsen der Diagnosekonvention in das Speicherformat oder den CBOR-Stream, obwohl die Darstellung eindeutig ist und dies möglich wäre.

Die CBOR-Diagnosenotation ist in Abschnitt 6 des RFC 7049 spezifiziert. Es handelt sich um eine textuelle Darstellung des CBOR-Streams, die JSON sehr ähnlich ist, jedoch auch CBOR-Typen unterstützt, die in JSON nicht vorkommen. Das durch das Flag „ ExtendedFormat “ aktivierte erweiterte Format befindet sich derzeit in einigen IETF-Entwürfen und kann sich noch ändern.

Diese Funktion erzeugt die äquivalente Darstellung des Streams, die ` toCbor()` erzeugen würde, ohne dass dort eine Transformationsoption angegeben wurde. Dies bedeutet auch, dass diese Funktion möglicherweise keine Darstellung des Streams erzeugt, der zur Erstellung des Objekts verwendet wurde, wenn dieses mit ` fromCbor()` erstellt wurde, da diese Funktion möglicherweise Transformationen angewendet hat. Eine originalgetreue Darstellung eines Streams ohne Transformationen finden Sie im Beispiel „ cbordump “.

Siehe auch ` toCbor()` und ` QJsonDocument::toJson()`.

double QCborValue::toDouble(double defaultValue = 0) const

Gibt den in diesem ` QCborValue` gespeicherten Gleitkommawert zurück, sofern dieser vom Typ `Double` ist. Handelt es sich um einen Wert vom Typ `Integer`, gibt diese Funktion den in den Typ `Double` konvertierten ganzzahligen Wert zurück. In allen anderen Fällen wird ` defaultValue` zurückgegeben.

Siehe auch isDouble(), isInteger() und toInteger().

qint64 QCborValue::toInteger(qint64 defaultValue = 0) const

Gibt den in diesem ` QCborValue` gespeicherten ganzzahligen Wert zurück, sofern dieser vom Typ „Integer“ ist. Handelt es sich um den Typ „Double“, gibt diese Funktion den in eine Ganzzahl konvertierten Gleitkommawert zurück. In allen anderen Fällen wird ` defaultValue` zurückgegeben.

Siehe auch isInteger(), isDouble() und toDouble().

QJsonValue QCborValue::toJsonValue() const

Konvertiert dieses „ QCborValue “-Objekt in eine äquivalente Darstellung im JSON-Format und gibt es als „ QJsonValue “ zurück.

Bitte beachten Sie, dass CBOR einen umfangreicheren und breiteren Typensatz enthält als JSON, sodass bei dieser Konvertierung möglicherweise einige Informationen verloren gehen. Die folgende Tabelle vergleicht CBOR-Typen mit JSON-Typen und gibt an, ob Informationen verloren gehen können oder nicht.

Informationen zur Konvertierung von CBOR-Map-Schlüsseln in Zeichenfolgen finden Sie unter QCborMap::toJsonObject().

Wenn dieses ` QCborValue ` den Wert `undefined` enthält, gibt diese Funktion ebenfalls ein `undefined`-` QJsonValue ` zurück. Beachten Sie, dass JSON keine undefinierten Werte unterstützt und undefinierte QJsonValues eine Erweiterung der Spezifikation darstellen. Sie können nicht in einem „ QJsonArray “ oder „ QJsonObject “ gespeichert werden, können jedoch von Funktionen zurückgegeben werden, um einen Fehler anzuzeigen. In allen anderen Fällen entsprechen sie dem Wert „null“.

Spezielle Behandlung von Tags und erweiterten Typen

Einige Tags werden speziell behandelt und verändern die Umwandlung des mit einem Tag versehenen Werts von CBOR in JSON. Die folgende Tabelle listet diese Sonderfälle auf:

Siehe auch ` fromJsonValue()`, ` toVariant()`, ` QCborArray::toJsonArray()` und ` QCborMap::toJsonObject()`.

Gibt den in diesem ` QCborValue` gespeicherten Map-Wert zurück, sofern dieser vom Typ „Map“ ist. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in ` QCborMap` durchführt.

Siehe auch „ isMap()“, „ isArray()“, „ isContainer()“ und „ toArray()“.

QRegularExpression QCborValue::toRegularExpression(const QRegularExpression &defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten Wert des regulären Ausdrucks zurück, sofern es sich um den erweiterten Typ eines regulären Ausdrucksmusters handelt. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in „ QRegularExpression “ durchführt.

Siehe auch „ isRegularExpression()“, „ isTag()“ und „ taggedValue()“.

QCborSimpleType QCborValue::toSimpleType(QCborSimpleType defaultValue = QCborSimpleType::Undefined) const

Gibt den einfachen Typ zurück, dem dieses „ QCborValue “ angehört, sofern es sich um einen einfachen Typ handelt. Ist es kein einfacher Typ, wird „ defaultValue “ zurückgegeben.

Die folgenden Typen sind einfache Typen, und diese Funktion gibt die aufgeführten Werte zurück:

Siehe auch „ type()“, „ isSimpleType()“, „ isBool()“, „ isTrue()“, „ isFalse()“, „ isNull()“ und „ isUndefined()“.

QString QCborValue::toString(const QString &defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten Zeichenfolgenwert zurück, sofern dieser vom Typ „Zeichenfolge“ ist. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in „ QString “ vornimmt.

Siehe auch „ toStringView()“, „ isString()“, „ isByteArray()“ und „ toByteArray()“.

[since 6.10] QAnyStringView QCborValue::toStringView(QAnyStringView defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten Zeichenfolgenwert zurück, sofern dieser vom Typ `string` ist. Andernfalls wird ` defaultValue` zurückgegeben. Da ` QCborValue ` Zeichenfolgen entweder im US-ASCII-, UTF-8- oder UTF-16-Format speichert, kann die zurückgegebene ` QAnyStringView ` in einer dieser Kodierungen vorliegen.

Diese Funktion reserviert keinen Speicher. Der Rückgabewert ist bis zum nächsten Aufruf einer nicht-konstanten Memberfunktion für dieses Objekt gültig. Wenn dieses Objekt den Gültigkeitsbereich verlässt, ist der Rückgabewert bis zum nächsten Aufruf einer nicht-konstanten Memberfunktion für das übergeordnete CBOR-Objekt (Map oder Array) gültig.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in „ QString “ durchführt.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` toString()`, ` isString()`, ` isByteArray()` und ` toByteArray()`.

QUrl QCborValue::toUrl(const QUrl &defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten URL-Wert zurück, sofern es sich um den erweiterten URL-Typ handelt. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in „ QUrl “ durchführt.

Siehe auch „ isUrl()“, „ isTag()“ und „ taggedValue()“.

QUuid QCborValue::toUuid(const QUuid &defaultValue = {}) const

Gibt den in diesem ` QCborValue` gespeicherten UUID-Wert zurück, sofern es sich um den erweiterten UUID-Typ handelt. Andernfalls wird ` defaultValue` zurückgegeben.

Beachten Sie, dass diese Funktion keine Konvertierung von anderen Typen in „ QUuid “ durchführt.

Siehe auch isUuid(), isTag() und taggedValue().

QVariant QCborValue::toVariant() const

Konvertiert diesen Wert in einen nativen Qt-Typ und gibt den entsprechenden ` QVariant` zurück.

Die folgende Tabelle listet die Zuordnung zwischen ` QCborValue types ` und ` Qt meta types` auf.

Beachten Sie, dass Werte sowohl in CBOR-Maps als auch in Arrays ebenfalls rekursiv mit dieser Funktion konvertiert und stattdessen in „ QVariantMap “ und „ QVariantList “ abgelegt werden. Die Werte „ QCborMap “ und „ QCborArray “ sind nicht in den QVariants gespeichert.

QVariantMaps haben im Gegensatz zu CBOR Zeichenfolgen-Schlüssel, sodass die Konvertierung von einem QCborMap in ein QVariantMap einen Schritt der „Zeichenfolgenumwandlung“ der Schlüsselwerte beinhaltet. Weitere Informationen finden Sie unter QCborMap::toJsonObject().

Siehe auch fromVariant(), toJsonValue(), QCborArray::toVariantList() und QCborMap::toVariantMap().

QCborValue::Type QCborValue::type() const

Gibt den Typ dieses QCborValue zurück. Der Typ kann später auch mit einer der „isXxx“-Funktionen abgerufen werden.

Siehe auch isInteger(), isByteArray(), isString(), isArray(), isMap(), isTag(), isFalse(), isTrue(), isBool(), isNull(), isUndefined, isDouble(), isDateTime(), isUrl(), isRegularExpression() und isUuid().

[noexcept] QCborValue &QCborValue::operator=(const QCborValue &other)

Ersetzt den Inhalt dieses QCborObject durch eine Kopie von other.

[noexcept] QCborValue &QCborValue::operator=(QCborValue &&other)

Verschiebt den Inhalt des Objekts other QCborValue in dieses Objekt und gibt die Ressourcen dieses Objekts frei. Gibt eine Referenz auf dieses Objekt zurück.

QCborValueRef QCborValue::operator[](const QString &key)

Gibt eine `QCborValueRef` zurück, mit der der Eintrag in dieser Map unter Verwendung der angegebenen ` key` gelesen oder geändert werden kann. Wenn diese ` QCborValue ` eine ` QCborMap` ist, entspricht diese Funktion dem entsprechenden Operator `[]` für diese Map.

Vor der Rückgabe der Referenz gilt: War dieses ` QCborValue ` ein Array, wird es zunächst in eine Map konvertiert (sodass ` map[i] ` für jeden Index ` array[i] ` ist, wobei ` i` und ` array[i]` gültig sind); andernfalls, wenn es keine Map war, wird es mit einer leeren Map überschrieben.

Siehe auch operator[](qint64), QCborMap::operator[], QCborMap::value() und QCborMap::find().

const QCborValue QCborValue::operator[](const QString &key) const

Wenn es sich bei diesem QCborValue um eine QCborMap handelt, wird nach Elementen gesucht, deren Wert mit dem Schlüssel key übereinstimmt. Wenn in der Map kein Schlüssel vorhanden ist, der mit key übereinstimmt, oder wenn dieses QCborValue -Objekt keine Map ist, wird der Wert „undefined“ zurückgegeben.

Diese Funktion entspricht:

value.toMap().value(key);

Siehe auch „ operator[]“ (qint64), „ QCborMap::operator[] “, „ QCborMap::value()“ und „ QCborMap::find()“.

QCborValueRef QCborValue::operator[](QLatin1StringView key)

Gibt eine `QCborValueRef` zurück, mit der der Eintrag in dieser Map unter Verwendung der angegebenen ` key` gelesen oder geändert werden kann. Wenn diese ` QCborValue ` ein ` QCborMap` ist, entspricht diese Funktion dem entsprechenden Operator `[]` für diese Map.

Vor der Rückgabe der Referenz gilt: War dieses ` QCborValue ` ein Array, wird es zunächst in eine Map konvertiert (sodass ` map[i] ` für jeden Index ` array[i] ` ist, wobei ` i` und ` array[i]` gültig sind); andernfalls, wenn es keine Map war, wird es mit einer leeren Map überschrieben.

Siehe auch operator[](qint64), QCborMap::operator[], QCborMap::value() und QCborMap::find().

QCborValueRef QCborValue::operator[](qint64 key)

Gibt eine `QCborValueRef` zurück, mit der der Eintrag in diesem Objekt – als Map oder Array – unter Verwendung des angegebenen ` key` gelesen oder geändert werden kann. Wenn dieser ` QCborValue ` ein ` QCborMap ` ist oder – für 0 <= key < 0x10000 – ein ` QCborArray`, entspricht diese Funktion dem entsprechenden Operator `[]` für diese Map oder dieses Array.

Vor der Rückgabe der Referenz: Wenn dieses „ QCborValue “ ein Array war, der Schlüssel jedoch außerhalb des zulässigen Bereichs liegt, wird das Array zunächst in eine Map umgewandelt (sodass „ map[i] “ für jeden Index „ array[i] “ ist, „ i “, mit gültigem „ array[i] “); andernfalls, wenn es keine Map war, wird es mit einer leeren Map überschrieben.

Siehe auch operator[], QCborMap::operator[], QCborMap::value(), QCborMap::find(), QCborArray::operator[] und QCborArray::at().

const QCborValue QCborValue::operator[](QLatin1StringView key) const

Wenn es sich bei diesem QCborValue um ein QCborMap handelt, wird nach Elementen gesucht, deren Wert mit key übereinstimmt. Wenn in der Map kein Schlüssel vorhanden ist, der mit key übereinstimmt, oder wenn dieses QCborValue -Objekt keine Map ist, wird der Wert „undefined“ zurückgegeben.

Diese Funktion entspricht:

value.toMap().value(key);

Siehe auch „ operator[]“ (qint64), „ QCborMap::operator[] “, „ QCborMap::value()“ und „ QCborMap::find()“.

const QCborValue QCborValue::operator[](qint64 key) const

Wenn es sich bei diesem QCborValue um ein QCborMap handelt, wird nach Elementen mit dem Wert gesucht, dessen Schlüssel mit key übereinstimmt. Handelt es sich um ein QCborArray, wird das Element mit dem Index key zurückgegeben. Wenn im Array oder in der Map kein passender Wert vorhanden ist oder wenn dieses QCborValue -Objekt kein Array oder keine Map ist, wird der Wert „undefined“ zurückgegeben.

Siehe auch „ operator[]“ , „ QCborMap::operator[] “, „ QCborMap::value()“, „ QCborMap::find()“, „ QCborArray::operator[] “ und „ QCborArray::at()“.