QJSManagedValue Class

Documentation sur les fonctions membres

[constexpr noexcept] QJSManagedValue::QJSManagedValue()

Crée une QJSManagedValue qui représente la valeur de JavaScript undefined. C'est la seule valeur qui n'est pas stockée sur le tas JavaScript. L'appel à engine() sur une QJSManagedValue construite par défaut renverra nullptr.

QJSManagedValue::QJSManagedValue(QJSValue value, QJSEngine *engine)

Crée une QJSManagedValue à partir de value, en utilisant le tas de engine. Si value est lui-même géré et que le moteur auquel il appartient n'est pas engine, le résultat est une valeur undefined, et un avertissement est généré.

QJSManagedValue::QJSManagedValue(const QJSPrimitiveValue &value, QJSEngine *engine)

Crée une QJSManagedValue à partir de value en utilisant le tas de engine.

QJSManagedValue::QJSManagedValue(const QString &string, QJSEngine *engine)

Crée une QJSManagedValue à partir de string en utilisant le tas de engine.

QJSManagedValue::QJSManagedValue(const QVariant &variant, QJSEngine *engine)

Crée une QJSManagedValue à partir de variant en utilisant le tas de engine.

QJSManagedValue::QJSManagedValue(QJSManagedValue &&other)

Move-construit une QJSManagedValue à partir de other. Cela laisse other dans l'état construit par défaut où il représente undefined et n'appartient à aucun moteur.

[noexcept] QJSManagedValue::~QJSManagedValue()

Détruit le site QJSManagedValue.

QJSValue QJSManagedValue::call(const QJSValueList &arguments = {}) const

Si ce QJSManagedValue représente un FunctionObject JavaScript, il l'appelle avec le arguments donné et renvoie le résultat. Sinon, il renvoie une valeur JavaScript undefined.

Les arguments doivent être des valeurs primitives ou appartenir au même QJSEngine que ce QJSManagedValue. Sinon, l'appel n'est pas exécuté et une valeur JavaScript undefined est renvoyée.

QJSValue QJSManagedValue::callAsConstructor(const QJSValueList &arguments = {}) const

Si ce QJSManagedValue représente un FunctionObject JavaScript, il l'appelle en tant que constructeur avec le arguments donné, et renvoie le résultat. Sinon, il renvoie une valeur JavaScript undefined.

Les arguments doivent être des valeurs primitives ou appartenir au même QJSEngine que ce QJSManagedValue. Sinon, l'appel n'est pas exécuté et une valeur JavaScript undefined est renvoyée.

QJSValue QJSManagedValue::callWithInstance(const QJSValue &instance, const QJSValueList &arguments = {}) const

Si ce QJSManagedValue représente un FunctionObject JavaScript, il l'appelle sur instance avec le arguments donné, et renvoie le résultat. Sinon, il renvoie une valeur JavaScript undefined.

Les arguments et instance doivent être des valeurs primitives ou appartenir au même QJSEngine que ce QJSManagedValue. Sinon, l'appel n'est pas exécuté et une valeur JavaScript undefined est renvoyée.

bool QJSManagedValue::deleteProperty(const QString &name)

Supprime la propriété name de ce site QJSManagedValue. Renvoie true si la suppression a réussi, ou false dans le cas contraire.

bool QJSManagedValue::deleteProperty(quint32 arrayIndex)

Supprime la valeur stockée à l'adresse arrayIndex de cette adresse QJSManagedValue. Renvoie true si la suppression a réussi, ou false dans le cas contraire.

QJSEngine *QJSManagedValue::engine() const

Renvoie l'adresse QJSEngine à laquelle appartient ce QJSManagedValue. Notez que le moteur est toujours valide, à moins que le QJSManagedValue ne soit construit par défaut ou déplacé. Dans ce dernier cas, une nullptr est renvoyée.

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

Invoque l'opérateur JavaScript '==' sur les sites QJSManagedValue et other, et renvoie le résultat.

Voir également strictlyEquals.

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

Renvoie true si ce QJSManagedValue a une propriété name, sinon renvoie false. Les propriétés de la chaîne de prototypes ne sont pas prises en compte.

bool QJSManagedValue::hasOwnProperty(quint32 arrayIndex) const

Renvoie true si ce QJSManagedValue a un index de tableau arrayIndex, sinon renvoie false. Les propriétés de la chaîne de prototypes ne sont pas prises en compte.

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

Renvoie true si ce QJSManagedValue a une propriété name, sinon renvoie false. Les propriétés de la chaîne de prototypes sont prises en compte.

bool QJSManagedValue::hasProperty(quint32 arrayIndex) const

Renvoie true si ce QJSManagedValue a un index de tableau arrayIndex, sinon renvoie false. Les propriétés de la chaîne de prototypes sont prises en compte.

bool QJSManagedValue::isArray() const

Renvoie true si cette valeur représente un objet JavaScript Array, ou false dans le cas contraire.

bool QJSManagedValue::isBoolean() const

Renvoie true si le type de ce QJSManagedValue est boolean, ou false dans le cas contraire.

bool QJSManagedValue::isDate() const

Renvoie true si cette valeur représente un objet JavaScript Date, ou false dans le cas contraire.

bool QJSManagedValue::isError() const

Renvoie true si cette valeur représente un objet JavaScript Error, ou false dans le cas contraire.

bool QJSManagedValue::isFunction() const

Renvoie true si le type de ce QJSManagedValue est function, false sinon.

bool QJSManagedValue::isInteger() const

Renvoie true si QJSManagedValue contient une valeur entière, ou false dans le cas contraire. Le format de stockage d'un nombre n'affecte pas le résultat des opérations effectuées sur celui-ci, mais si un entier est stocké, de nombreuses opérations sont plus rapides.

bool QJSManagedValue::isNull() const

Renvoie true si ce QJSManagedValue contient la valeur JavaScript null, ou false dans le cas contraire.

bool QJSManagedValue::isNumber() const

Renvoie true si le type de ce QJSManagedValue est number, ou false dans le cas contraire.

bool QJSManagedValue::isObject() const

Renvoie true si le type de ce QJSManagedValue est object, ou false dans le cas contraire.

bool QJSManagedValue::isQMetaObject() const

Renvoie true si cette valeur représente un pointeur QMetaObject géré sur le tas JavaScript, ou false dans le cas contraire.

bool QJSManagedValue::isQObject() const

Renvoie true si cette valeur représente un pointeur QObject géré sur le tas JavaScript, ou false dans le cas contraire.

bool QJSManagedValue::isRegularExpression() const

Renvoie true si cette valeur représente un objet d'expression régulière JavaScript, ou false dans le cas contraire.

bool QJSManagedValue::isString() const

Renvoie true si le type de ce QJSManagedValue est string, ou false dans le cas contraire.

bool QJSManagedValue::isSymbol() const

Renvoie true si le type de ce QJSManagedValue est symbol, ou false dans le cas contraire.

bool QJSManagedValue::isUndefined() const

Renvoie true si le type de ce QJSManagedValue est undefined, ou false dans le cas contraire.

bool QJSManagedValue::isUrl() const

Renvoie true si cette valeur représente un objet JavaScript Url, ou false dans le cas contraire.

bool QJSManagedValue::isVariant() const

Renvoie true si cette valeur représente un QVariant géré sur le tas JavaScript, ou false dans le cas contraire.

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

Renvoie la propriété name de ce QJSManagedValue. La chaîne de prototypes est consultée si la propriété n'est pas trouvée sur l'objet réel.

Voir aussi setProperty().

QJSValue QJSManagedValue::property(quint32 arrayIndex) const

Renvoie la propriété stockée à l'adresse arrayIndex de ce QJSManagedValue. La chaîne de prototypes est consultée si la propriété n'est pas trouvée sur l'objet réel.

QJSManagedValue QJSManagedValue::prototype() const

Renvoie le prototype de cette QJSManagedValue. Cela fonctionne avec n'importe quelle valeur. Vous pouvez, par exemple, récupérer le prototype JavaScript boolean à partir d'une valeur boolean.

Voir aussi setPrototype().

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

Définit la propriété name à value sur ce QJSManagedValue. Cette opération ne peut être effectuée que sur des valeurs JavaScript de type object. De plus, value doit être une primitive ou appartenir au même moteur que cette valeur.

Voir aussi property().

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

Stocke la valeur value à arrayIndex dans cette valeur QJSManagedValue. Cette opération ne peut être effectuée que sur des valeurs JavaScript de type object, et n'est pas recommandée si la valeur n'est pas un tableau. De plus, value doit être une primitive ou appartenir au même moteur que cette valeur.

void QJSManagedValue::setPrototype(const QJSManagedValue &prototype)

Définit le prototype de ce QJSManagedValue à prototype. Une condition préalable est que prototype appartienne au même QJSEngine que ce QJSManagedValue et soit un objet (y compris null). En outre, ce QJSManagedValue doit également être un objet (à l'exclusion de null), et vous ne pouvez pas créer de cycles de prototypes.

Voir aussi prototype().

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

Invoque l'opérateur JavaScript '===' sur ce site QJSManagedValue et other, et renvoie le résultat.

Voir également equals.

bool QJSManagedValue::toBoolean() const

Convertit la valeur gérée en un booléen. Si la valeur gérée contient un booléen, celui-ci est renvoyé. Sinon, une coercion booléenne est effectuée selon les règles JavaScript.

QDateTime QJSManagedValue::toDateTime() const

Si cette adresse QJSManagedValue contient un objet JavaScript Date, elle renvoie une adresse QDateTime équivalente. Sinon, il renvoie un objet invalide.

int QJSManagedValue::toInteger() const

Convertit la valeur gérée en un entier. Ceci convertit d'abord la valeur en un nombre selon les règles de toNumber(), puis l'enferme dans la plage des entiers selon les règles données pour contraindre les arguments des opérateurs de décalage de bits JavaScript en entiers de 32 bits.

En interne, la valeur peut déjà être stockée sous la forme d'un entier, auquel cas un chemin rapide est emprunté.

QJSValue QJSManagedValue::toJSValue() const

Copie ce QJSManagedValue dans un nouveau QJSValue. Ceci est moins efficace que de construire un QJSValue à partir d'un QJSManagedValue, mais conserve le QJSManagedValue.

double QJSManagedValue::toNumber() const

Convertit la valeur gérée en un nombre. Si la valeur gérée contient un nombre, celui-ci est renvoyé. Dans le cas contraire, une coercion des nombres selon les règles JavaScript est effectuée.

QJSPrimitiveValue QJSManagedValue::toPrimitive() const

Convertit la valeur gérée en QJSPrimitiveValue. Si la valeur gérée contient un type pris en charge par QJSPrimitiveValue, la valeur est copiée. Sinon, la valeur est convertie en chaîne de caractères, et la chaîne est stockée dans QJSPrimitiveValue.

const QMetaObject *QJSManagedValue::toQMetaObject() const

Si ce site QJSManagedValue contient un pointeur QMetaObject, il le renvoie. Sinon, il renvoie nullptr.

QObject *QJSManagedValue::toQObject() const

Si ce site QJSManagedValue contient un pointeur QObject, il le renvoie. Sinon, il renvoie nullptr.

QRegularExpression QJSManagedValue::toRegularExpression() const

Si cette adresse QJSManagedValue contient un objet d'expression régulière JavaScript, elle renvoie une adresse QRegularExpression équivalente. Sinon, il renvoie une expression non valide.

QString QJSManagedValue::toString() const

Convertit la valeur gérée en chaîne de caractères. Si la valeur gérée contient une chaîne, celle-ci est renvoyée. Dans le cas contraire, une coercion de chaîne selon les règles JavaScript est effectuée.

QUrl QJSManagedValue::toUrl() const

Si cette adresse QJSManagedValue contient un objet JavaScript Url, elle renvoie une adresse QUrl équivalente. Sinon, il renvoie un objet invalide.

QVariant QJSManagedValue::toVariant() const

Copie ce QJSManagedValue dans un nouveau QVariant. Cela crée également un QVariant utile si QJSManagedValue::isVariant() retourne false. QVariant peut contenir tous les types supportés par QJSManagedValue.

QJSManagedValue::Type QJSManagedValue::type() const

Renvoie le type JavaScript de cette QJSManagedValue.

QJSManagedValue &QJSManagedValue::operator=(QJSManagedValue &&other)

Move-assigns a QJSManagedValue from other. Cela laisse other dans l'état de construction par défaut où il représente undefined et n'appartient à aucun moteur.