QJSValue Class

Dokumentation zu Mitgliedsfunktionen

QJSValue::QJSValue(QJSValue::SpecialValue value = UndefinedValue)

Erstellt einen neuen QJSValue mit einem speziellen „ value “.

QJSValue::QJSValue(bool value)

Erstellt einen neuen QJSValue mit einem booleschen Wert „ value “.

QJSValue::QJSValue(const QLatin1String &value)

Erstellt einen neuen QJSValue mit dem String- value.

QJSValue::QJSValue(const QString &value)

Erstellt einen neuen QJSValue mit dem String- value.

QJSValue::QJSValue(const char *value)

Erstellt einen neuen QJSValue mit dem String- value.

QJSValue::QJSValue(double value)

Erzeugt einen neuen QJSValue mit einem Zahlen value.

QJSValue::QJSValue(int value)

Erstellt einen neuen QJSValue mit einem Zahlen value.

QJSValue::QJSValue(uint value)

Erstellt einen neuen QJSValue mit einem Zahlen value.

QJSValue::QJSValue(const QJSValue &other)

Erstellt einen neuen QJSValue, der eine Kopie von other ist.

Beachten Sie: Wenn „ other “ ein Objekt ist (d. h., „ isObject()“ würde „true“ zurückgeben), wird nur eine Referenz auf das zugrunde liegende Objekt in den neuen Skriptwert kopiert (d. h., das Objekt selbst wird nicht kopiert).

QJSValue::QJSValue(QJSValue &&other)

Move-Konstruktor. Überträgt Daten von other in dieses QJSValue-Objekt.

[noexcept] QJSValue::~QJSValue()

Löscht diese Seite: QJSValue.

QJSValue QJSValue::call(const QJSValueList &args = QJSValueList()) const

Ruft „ QJSValue “ als Funktion auf, übergibt „ args “ als Argumente an die Funktion und verwendet „globalObject()“ als „this“-Objekt. Gibt den von der Funktion zurückgegebenen Wert zurück.

Wenn diese ` QJSValue ` nicht aufrufbar ist, führt `call()` keine Aktion aus und gibt ein undefiniertes ` QJSValue` zurück.

Der Aufruf von `call()` kann eine Ausnahme in der Skript-Engine auslösen; in diesem Fall gibt `call()` den Wert zurück, der ausgelöst wurde (in der Regel ein ` Error `-Objekt). Sie können ` isError()` auf den Rückgabewert anwenden, um festzustellen, ob eine Ausnahme aufgetreten ist.

Siehe auch ` isCallable()`, ` callWithInstance()` und ` callAsConstructor()`.

QJSValue QJSValue::callAsConstructor(const QJSValueList &args = QJSValueList()) const

Erstellt ein neues ` Object ` und ruft dieses ` QJSValue ` als Konstruktor auf, wobei das erstellte Objekt als `this`-Objekt verwendet und ` args ` als Argumente übergeben werden. Ist der Rückgabewert des Konstruktoraufrufs ein Objekt, wird dieses Objekt zurückgegeben; andernfalls wird das standardmäßig erstellte Objekt zurückgegeben.

Ist dieses ` QJSValue ` keine Funktion, führt `callAsConstructor()` keine Aktion aus und gibt ein undefiniertes ` QJSValue` zurück.

Der Aufruf dieser Funktion kann eine Ausnahme in der Skript-Engine auslösen; in diesem Fall wird der ausgelöste Wert (in der Regel ein ` Error `-Objekt) zurückgegeben. Sie können ` isError()` auf den Rückgabewert anwenden, um festzustellen, ob eine Ausnahme aufgetreten ist.

Siehe auch ` call()` und ` QJSEngine::newObject()`.

QJSValue QJSValue::callWithInstance(const QJSValue &instance, const QJSValueList &args = QJSValueList()) const

Ruft „ QJSValue “ als Funktion auf, wobei „ instance “ als „this“-Objekt im Funktionsaufruf verwendet wird und „ args “ als Argumente an die Funktion übergeben werden. Gibt den von der Funktion zurückgegebenen Wert zurück.

Wenn „ QJSValue “ keine Funktion ist, führt „ call()“ keine Aktion aus und gibt ein undefiniertes „ QJSValue “ zurück.

Beachten Sie, dass, wenn ` instance ` kein Objekt ist, das globale Objekt (siehe ` QJSEngine::globalObject()`) als `this`-Objekt verwendet wird.

Der Aufruf von ` call()` kann eine Ausnahme in der Skript-Engine auslösen; in diesem Fall gibt ` call()` den Wert zurück, der ausgelöst wurde (in der Regel ein ` Error `-Objekt). Sie können ` isError()` auf den Rückgabewert anwenden, um festzustellen, ob eine Ausnahme aufgetreten ist.

Siehe auch call().

bool QJSValue::deleteProperty(const QString &name)

Versucht, die Eigenschaft dieses Objekts mit dem angegebenen name zu löschen. Gibt „true“ zurück, wenn die Eigenschaft gelöscht wurde, andernfalls „false“.

Das Verhalten dieser Funktion entspricht dem JavaScript-Operator „delete“. Insbesondere gilt:

• Nicht konfigurierbare Eigenschaften können nicht gelöscht werden.
• Diese Funktion gibt „true“ zurück, selbst wenn dieses Objekt keine Eigenschaft mit dem angegebenen name besitzt (d. h., nicht vorhandene Eigenschaften sind „trivial löschbar“).
• Wenn dieses Objekt keine eigene Eigenschaft mit dem angegebenen „ name “ besitzt, ein Objekt in der „ prototype()“-Kette jedoch schon, wird die Eigenschaft des Prototyp-Objekts nicht gelöscht, und diese Funktion gibt „true“ zurück.

Siehe auch ` setProperty()` und ` hasOwnProperty()`.

bool QJSValue::equals(const QJSValue &other) const

Gibt „true“ zurück, wenn dieser QJSValue gleich other ist, andernfalls „false“. Der Vergleich folgt dem in ECMA-262, Abschnitt 11.9.3, „The Abstract Equality Comparison Algorithm“ beschriebenen Verhalten.

Diese Funktion kann auch dann „true“ zurückgeben, wenn sich der Typ dieses ` QJSValue ` vom Typ des Wertes ` other ` unterscheidet; d. h., der Vergleich ist nicht streng. Beispielsweise liefert der Vergleich der Zahl 9 mit der Zeichenkette „9“ den Wert „true“; der Vergleich eines undefinierten Werts mit einem Nullwert liefert den Wert „true“; der Vergleich eines „ Number “-Objekts, dessen primitiver Wert 6 ist, mit einem „ String “-Objekt, dessen primitiver Wert „6“ ist, liefert den Wert „true“; und der Vergleich der Zahl 1 mit dem booleschen Wert „ true “ liefert den Wert „true“. Wenn Sie einen Vergleich ohne eine solche implizite Wertkonvertierung durchführen möchten, verwenden Sie „ strictlyEquals()“.

Beachten Sie, dass der Aufruf dieser Funktion Nebenwirkungen auf die Skript-Engine hat, wenn „ QJSValue “ oder „ other “ Objekte sind, da die Engine die Funktion „valueOf()“ des Objekts (und möglicherweise „ toString()“) aufruft, um das Objekt in einen primitiven Wert zu konvertieren (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt).

Siehe auch ` strictlyEquals()`.

QJSValue::ErrorType QJSValue::errorType() const

Gibt den Fehlertyp zurück, den diese QJSValue darstellt, sofern es sich um ein Error-Objekt handelt. Andernfalls wird Folgendes zurückgegeben NoError."

Siehe auch ` isError()` und ` QJSEngine - Script Exceptions`.

bool QJSValue::hasOwnProperty(const QString &name) const

Gibt „true“ zurück, wenn dieses Objekt eine eigene (nicht über den Prototyp geerbte) Eigenschaft mit dem angegebenen name besitzt; andernfalls wird „false“ zurückgegeben.

Siehe auch ` property()` und ` hasProperty()`.

bool QJSValue::hasProperty(const QString &name) const

Gibt „true“ zurück, wenn dieses Objekt eine Eigenschaft mit dem angegebenen Namen „ name “ besitzt, andernfalls „false“.

Siehe auch ` property()` und ` hasOwnProperty()`.

bool QJSValue::isArray() const

Gibt „true“ zurück, wenn dieses „ QJSValue “ ein Objekt der Klasse „Array“ ist; andernfalls wird „false“ zurückgegeben.

Siehe auch ` QJSEngine::newArray()`.

bool QJSValue::isBool() const

Gibt „true“ zurück, wenn dieses „ QJSValue “ vom primitiven Typ „Boolean“ ist; andernfalls wird „false“ zurückgegeben.

Siehe auch ` toBool()`.

bool QJSValue::isCallable() const

Gibt „true“ zurück, wenn dieses „ QJSValue “ eine Funktion ist, andernfalls „false“.

Siehe auch ` call()`.

bool QJSValue::isDate() const

Gibt „true“ zurück, wenn diese „ QJSValue “ ein Objekt der Klasse „Date“ ist; andernfalls wird „false“ zurückgegeben.

bool QJSValue::isError() const

Gibt „true“ zurück, wenn dieses „ QJSValue “ ein Objekt der Klasse „Error“ ist; andernfalls wird „false“ zurückgegeben.

Siehe auch ` errorType()` und ` QJSEngine - Script Exceptions`.

bool QJSValue::isNull() const

Gibt „true“ zurück, wenn diese „ QJSValue “ vom primitiven Typ „Null“ ist; andernfalls wird „false“ zurückgegeben.

bool QJSValue::isNumber() const

Gibt „true“ zurück, wenn dieser „ QJSValue “ vom primitiven Typ „Number“ ist; andernfalls wird „false“ zurückgegeben.

Siehe auch ` toNumber()`.

bool QJSValue::isObject() const

Gibt „true“ zurück, wenn diese „ QJSValue “ vom Typ „Object“ ist; andernfalls gibt sie „false“ zurück.

Beachten Sie, dass Funktionswerte, Variant-Werte und „ QObject “-Werte Objekte sind, sodass diese Funktion für solche Werte „true“ zurückgibt.

Siehe auch „ QJSEngine::newObject()“.

bool QJSValue::isQMetaObject() const

Gibt „true“ zurück, wenn dieses ` QJSValue ` ein ` QMetaObject` ist; andernfalls wird „false“ zurückgegeben.

Siehe auch „ toQMetaObject()“ und „ QJSEngine::newQMetaObject()“.

bool QJSValue::isQObject() const

Gibt „true“ zurück, wenn diese „ QJSValue “ eine „ QObject “ ist; andernfalls wird „false“ zurückgegeben.

Hinweis: Diese Funktion gibt auch dann „true“ zurück, wenn der „ QObject “, den dieser „ QJSValue “ umschließt, gelöscht wurde.

Siehe auch „ toQObject()“ und „ QJSEngine::newQObject()“.

bool QJSValue::isRegExp() const

Gibt „true“ zurück, wenn dieses „ QJSValue “ ein Objekt der Klasse „RegExp“ ist; andernfalls wird „false“ zurückgegeben.

bool QJSValue::isString() const

Gibt „true“ zurück, wenn dieses „ QJSValue “ vom primitiven Typ „String“ ist; andernfalls wird „false“ zurückgegeben.

Siehe auch ` toString()`.

bool QJSValue::isUndefined() const

Gibt „true“ zurück, wenn dieser „ QJSValue “ vom primitiven Typ „Undefined“ ist oder wenn der verwaltete Wert gelöscht wurde (durch Löschen der Engine). Andernfalls wird „false“ zurückgegeben.

bool QJSValue::isUrl() const

Gibt „true“ zurück, wenn dieses ` QJSValue ` ein Objekt der JavaScript-Klasse `URL` ist; andernfalls gibt es „false“ zurück.

QJSValue QJSValue::property(const QString &name) const

Gibt den Wert der Eigenschaft dieses „ QJSValue “ mit dem angegebenen „ name “ zurück. Falls keine solche Eigenschaft existiert, wird ein undefinierter „ QJSValue “ zurückgegeben.

Wenn die Eigenschaft mithilfe einer Getter-Funktion implementiert ist (d. h. das Flag „PropertyGetter“ ist gesetzt), hat der Aufruf von `property()` Nebenwirkungen auf die Skript-Engine, da die Getter-Funktion aufgerufen wird (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt). Wenn eine Ausnahme aufgetreten ist, gibt `property()` den Wert zurück, der ausgelöst wurde (in der Regel ein ` Error `-Objekt).

Um auf Array-Elemente zuzugreifen, verwenden Sie stattdessen die Überladung „ setProperty(quint32 arrayIndex, const QJSValue &value)“.

Siehe auch ` setProperty()`, ` hasProperty()` und ` QJSValueIterator`.

QJSValue QJSValue::property(quint32 arrayIndex) const

Gibt die Eigenschaft an der angegebenen Position „ arrayIndex “ zurück.

Es gibt zwei Möglichkeiten, auf Elemente in einem Array zuzugreifen. Die erste besteht darin, den Array-Index als Eigenschaftsnamen zu verwenden:

qDebug() << jsValueArray.property(QLatin1String("4")).toString();

Die zweite besteht darin, die Überladung zu verwenden, die einen Index akzeptiert:

qDebug() << jsValueArray.property(4).toString();

Beide Ansätze führen zum gleichen Ergebnis, mit dem Unterschied, dass der letztere:

• einfacher zu verwenden ist (eine Ganzzahl kann direkt verwendet werden)
• schneller ist (keine Umwandlung in eine Ganzzahl)

Wenn dieses ` QJSValue ` kein Array-Objekt ist, verhält sich diese Funktion so, als wäre `property()` mit der Zeichenfolgendarstellung von ` arrayIndex` aufgerufen worden.

QJSValue QJSValue::prototype() const

Wenn dieses QJSValue ein Objekt ist, gibt die Methode den internen Prototyp (Eigenschaft „__proto__ “) dieses Objekts zurück; andernfalls gibt sie „undefined“ QJSValue zurück.

Siehe auch setPrototype() und isObject().

void QJSValue::setProperty(const QString &name, const QJSValue &value)

Setzt den Wert der Eigenschaft dieses „ QJSValue “ mit dem angegebenen „ name “ auf den angegebenen „ value “.

Wenn dieses „ QJSValue “ kein Objekt ist, führt diese Funktion keine Aktion aus.

Wenn dieses ` QJSValue ` noch keine Eigenschaft mit dem Namen ` name` besitzt, wird eine neue Eigenschaft erstellt.

Um Array-Elemente zu ändern, verwenden Sie stattdessen die Überladung von ` setProperty(quint32 arrayIndex, const QJSValue &value)`.

Siehe auch „ property()“ und „ deleteProperty()“.

void QJSValue::setProperty(quint32 arrayIndex, const QJSValue &value)

Setzt die Eigenschaft unter dem angegebenen Index „ arrayIndex “ auf den angegebenen Wert „ value “.

Es gibt zwei Möglichkeiten, Elemente in einem Array zu ändern. Die erste besteht darin, den Array-Index als Eigenschaftsnamen zu verwenden:

jsValueArray.setProperty(QLatin1String("4"), value);

Die zweite besteht darin, die Überladung zu verwenden, die einen Index akzeptiert:

jsValueArray.setProperty(4, value);

Beide Ansätze führen zum gleichen Ergebnis, mit dem Unterschied, dass letzterer:

• einfacher zu verwenden ist (eine Ganzzahl kann direkt verwendet werden)
• schneller ist (keine Umwandlung in eine Ganzzahl)

Wenn dieses ` QJSValue ` kein Array-Objekt ist, verhält sich diese Funktion so, als wäre `setProperty()` mit der Zeichenfolgendarstellung von ` arrayIndex` aufgerufen worden.

Siehe auch ` property(quint32 arrayIndex)` und ` Working With Arrays`.

void QJSValue::setPrototype(const QJSValue &prototype)

Wenn „ QJSValue “ ein Objekt ist, wird der interne Prototyp (Eigenschaft „__proto__ “) dieses Objekts auf „ prototype “ gesetzt; ist „ QJSValue “ null, wird der Prototyp auf null gesetzt; andernfalls erfolgt keine Änderung.

Der interne Prototyp ist nicht zu verwechseln mit der öffentlichen Eigenschaft namens „prototype“; der öffentliche Prototyp wird in der Regel nur für Funktionen gesetzt, die als Konstruktoren fungieren.

Siehe auch prototype() und isObject().

bool QJSValue::strictlyEquals(const QJSValue &other) const

Gibt „true“ zurück, wenn dieser Wert QJSValue unter strikter Vergleichsregel (ohne Konvertierung) gleich other ist; andernfalls wird „false“ zurückgegeben. Der Vergleich folgt dem in ECMA-262, Abschnitt 11.9.6, „Der Algorithmus für den strikten Gleichheitsvergleich“ beschriebenen Verhalten.

Wenn sich der Typ dieses ` QJSValue ` vom Typ des Wertes ` other ` unterscheidet, gibt diese Funktion `false` zurück. Sind die Typen gleich, hängt das Ergebnis vom jeweiligen Typ ab, wie in der folgenden Tabelle dargestellt:

Siehe auch ` equals()`.

bool QJSValue::toBool() const

Gibt den booleschen Wert dieses ` QJSValue` zurück, wobei die in ECMA-262, Abschnitt 9.2, „ToBoolean“ beschriebenen Konvertierungsregeln angewendet werden.

Beachten Sie, dass der Aufruf dieser Funktion Nebenwirkungen auf die Skript-Engine hat, wenn dieses ` QJSValue ` ein Objekt ist, da die Engine die Funktion `valueOf()` des Objekts (und möglicherweise ` toString()`) aufruft, um das Objekt in einen primitiven Wert zu konvertieren (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt).

Siehe auch ` isBool()`.

QDateTime QJSValue::toDateTime() const

Gibt eine Darstellung dieses Wertes im Format „ QDateTime “ in Ortszeit zurück. Wenn dieser Wert „ QJSValue “ kein Datum ist oder der Wert des Datums „NaN“ (Not-a-Number) ist, wird ein ungültiger Wert „ QDateTime “ zurückgegeben.

Siehe auch isDate().

qint32 QJSValue::toInt() const

Gibt den vorzeichenbehafteten 32-Bit-Ganzzahlwert dieses ` QJSValue` unter Verwendung der in ECMA-262, Abschnitt 9.5, „ToInt32“ beschriebenen Konvertierungsregeln zurück.

Beachten Sie, dass der Aufruf dieser Funktion Nebenwirkungen auf die Skript-Engine hat, wenn dieses ` QJSValue ` ein Objekt ist, da die Engine die `valueOf()`-Funktion des Objekts (und möglicherweise ` toString()`) aufruft, um das Objekt in einen primitiven Wert zu konvertieren (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt).

Siehe auch ` toNumber()` und ` toUInt()`.

double QJSValue::toNumber() const

Gibt den Zahlenwert dieses ` QJSValue` zurück, wie in ECMA-262, Abschnitt 9.3, „ToNumber“, definiert.

Beachten Sie, dass der Aufruf dieser Funktion Nebenwirkungen auf die Skript-Engine hat, wenn es sich bei diesem „ QJSValue “ um ein Objekt handelt, da die Engine die Funktion „valueOf()“ des Objekts (und möglicherweise „ toString()“) aufruft, um das Objekt in einen primitiven Wert zu konvertieren (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt).

Siehe auch „ isNumber()“, „ toInt()“ und „ toUInt()“.

QJSPrimitiveValue QJSValue::toPrimitive() const

Konvertiert den Wert in ein ` QJSPrimitiveValue`. Wenn der Wert einen von ` QJSPrimitiveValue` unterstützten Typ hat, wird der Wert kopiert. Andernfalls wird der Wert in eine Zeichenkette konvertiert und die Zeichenkette in ` QJSPrimitiveValue` gespeichert.

const QMetaObject *QJSValue::toQMetaObject() const

* Wenn diese ` QJSValue ` ein ` QMetaObject` ist, gibt die Funktion den Zeiger ` QMetaObject ` zurück, * den die ` QJSValue ` repräsentiert; andernfalls gibt sie ` nullptr` zurück. * *

Siehe auch isQMetaObject().

QObject *QJSValue::toQObject() const

Wenn diese „ QJSValue “ ein „ QObject “ ist, gibt die Funktion den „ QObject “-Zeiger zurück, den die „ QJSValue “ repräsentiert; andernfalls gibt sie „ nullptr “ zurück.

Wenn der QObject, den dieser QJSValue umschließt, gelöscht wurde, gibt diese Funktion nullptr zurück (d. h., es ist möglich, dass toQObject() nullptr zurückgibt, selbst wenn isQObject() „true“ zurückgibt).

Siehe auch isQObject().

QString QJSValue::toString() const

Gibt den Zeichenfolgenwert dieses ` QJSValue` zurück, wie in ECMA-262, Abschnitt 9.8, „ToString“, definiert.

Beachten Sie, dass der Aufruf dieser Funktion, falls dieses ` QJSValue ` ein Objekt ist, Nebenwirkungen auf die Skript-Engine hat, da die Engine die Funktion `toString()` (und möglicherweise `valueOf()`) des Objekts aufruft, um das Objekt in einen primitiven Wert zu konvertieren (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt).

Siehe auch ` isString()`.

quint32 QJSValue::toUInt() const

Gibt den vorzeichenlosen 32-Bit-Ganzzahlwert dieses ` QJSValue` zurück, wobei die in ECMA-262, Abschnitt 9.6, „ToUint32“ beschriebenen Konvertierungsregeln angewendet werden.

Beachten Sie, dass der Aufruf dieser Funktion Nebenwirkungen auf die Skript-Engine hat, wenn dieses ` QJSValue ` ein Objekt ist, da die Engine die Funktion `valueOf()` des Objekts (und möglicherweise ` toString()`) aufruft, um das Objekt in einen primitiven Wert zu konvertieren (was möglicherweise zu einer nicht abgefangenen Skript-Ausnahme führt).

Siehe auch ` toNumber()` und ` toInt()`.

QVariant QJSValue::toVariant(QJSValue::ObjectConversionBehavior behavior) const

Gibt den Wert „ QVariant “ dieses „ QJSValue “ zurück, sofern er in einen „ QVariant “ konvertiert werden kann; andernfalls wird ein ungültiger „ QVariant “ zurückgegeben. Einige JavaScript-Typen und -Objekte verfügen in Qt über native Ausdrücke. Diese werden in ihre nativen Ausdrücke konvertiert. Beispiel:

Für andere Typen ist der Parameter „ behavior “ relevant. Wenn „ ConvertJSObjects “ angegeben wird, wird eine bestmögliche, aber möglicherweise verlustbehaftete Konvertierung versucht. Generische JavaScript-Objekte werden in ` QVariantMap` konvertiert. JavaScript-Arrays werden in ` QVariantList` konvertiert. Jede Eigenschaft bzw. jedes Element wird rekursiv in ein ` QVariant` konvertiert; zyklische Referenzen werden nicht verfolgt. JavaScript-Funktionsobjekte werden verworfen. Wenn ` RetainJSObjects ` angegeben ist, wird das ` QJSValue ` über ` QVariant::fromValue()` in ein ` QVariant ` verpackt. Die resultierende Konvertierung ist verlustfrei, aber die interne Struktur der Objekte ist nicht unmittelbar zugänglich.

Siehe auch ` isVariant()`.

QVariant QJSValue::toVariant() const

Gibt `toVariant(ConvertJSObjects)` zurück.

Siehe auch ` isVariant()`.

QJSValue &QJSValue::operator=(QJSValue &&other)

Weist dem Objekt „ QJSValue “ das Objekt „ “ zu. zu diesem Objekt „ “ zu. zu diesem Objekt „ “ zu. zu diesem Objekt „ “ zu. other zu diesem Objekt „ “ zu. zu diesem Objekt „ “ zu. zu diesem Objekt „ “ zu. zu diesem Objekt „ “ zu. zu diesem Objekt „ “ zu

QJSValue &QJSValue::operator=(const QJSValue &other)

Weist diesem ` QJSValue` den Wert von ` other ` zu.

Beachten Sie, dass, wenn other ein Objekt ist (isObject() gibt „true“ zurück), nur eine Referenz auf das zugrunde liegende Objekt zugewiesen wird; das Objekt selbst wird nicht kopiert.