QJSManagedValue Class

Documentation sur les fonctions membres

[constexpr noexcept default] QJSManagedValue::QJSManagedValue()

Crée un objet `QJSManagedValue` représentant la valeur ` undefined ` de JavaScript. Il s'agit de la seule valeur qui n'est pas stockée dans le tas de JavaScript. L'appel de la fonction ` engine()` sur un objet `QJSManagedValue` construit par défaut renverra `nullptr`.

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

Crée un objet `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 un objet `QJSManagedValue` à partir d'un objet ` value ` en utilisant le tas de ` engine`.

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

Crée un objet `QJSManagedValue` à partir d'un objet ` string ` en utilisant le tas de l'objet ` engine`.

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

Crée un objet `QJSManagedValue` à partir d'un objet ` variant ` en utilisant le tas de ` engine`.

QJSManagedValue::QJSManagedValue(QJSManagedValue &&other)

Crée un objet `QJSManagedValue` à partir de ` other`. Cela laisse ` other ` dans son état de construction par défaut, où il représente la valeur « undefined » et n'appartient à aucun moteur.

[noexcept] QJSManagedValue::~QJSManagedValue()

Détruit l'QJSManagedValue.

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

Si cet QJSManagedValue représente un FunctionObject JavaScript, il l'appelle avec l'arguments on fournie et renvoie le résultat. Sinon, il renvoie une valeur de type undefined JavaScript.

Les arguments doivent être soit des valeurs primitives, soit 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 cet QJSManagedValue représente un FunctionObject JavaScript, il l'appelle en tant que constructeur avec l'arguments on fournie et renvoie le résultat. Sinon, il renvoie une valeur de type undefined JavaScript.

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

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

Si cet QJSManagedValue représente un FunctionObject JavaScript, la fonction l’appelle via instance avec l’ arguments fournie, puis renvoie le résultat. Sinon, elle renvoie une valeur undefined JavaScript.

L'arguments et l'instance doivent être soit des valeurs primitives, soit appartenir au même QJSEngine que cet QJSManagedValue. Dans le cas contraire, l'appel n'est pas exécuté et une valeur JavaScript de type undefined est renvoyée.

bool QJSManagedValue::deleteProperty(const QString &name)

Supprime la propriété « name » de cet objet « 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 à partir de cette adresse QJSManagedValue. Renvoie true si la suppression a réussi, ou false dans le cas contraire.

QJSEngine *QJSManagedValue::engine() const

Renvoie l'QJSEngine e à laquelle appartient cet QJSManagedValue. Notez que l'engine est toujours valide, sauf si l'QJSManagedValue e a été initialisé par défaut ou déplacé. Dans ce dernier cas, un nullptr est renvoyé.

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

Appelle l'opérateur JavaScript « == » sur ces liens QJSManagedValue et other, puis renvoie le résultat.

Voir également strictlyEquals.

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

Renvoie « true » si cet objet « QJSManagedValue » possède 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 l'QJSManagedValue ` possède 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 cet objet ` QJSManagedValue ` possède 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 cet objet « QJSManagedValue » possède 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 correspond à un objet Array de JavaScript, ou « false » dans le cas contraire.

bool QJSManagedValue::isBoolean() const

Renvoie « true » si le type de cet objet ` QJSManagedValue ` est ` boolean`, ou « false » dans le cas contraire.

bool QJSManagedValue::isDate() const

Renvoie « true » si cette valeur correspond à un objet Date de JavaScript, ou « false » dans le cas contraire.

bool QJSManagedValue::isError() const

Renvoie « true » si cette valeur correspond à un objet « Error » de JavaScript, ou « false » dans le cas contraire.

bool QJSManagedValue::isFunction() const

Renvoie « true » si le type de cet « QJSManagedValue » est « function », et « false » dans le cas contraire.

bool QJSManagedValue::isInteger() const

Renvoie « true » si cette variable QJSManagedValue contient une valeur entière, ou « false » dans le cas contraire. Le format de stockage d'un nombre n'a aucune incidence sur le résultat des opérations effectuées sur celui-ci, mais si la variable contient un entier, de nombreuses opérations s'effectuent plus rapidement.

bool QJSManagedValue::isNull() const

Renvoie « true » si l'QJSManagedValue contient la valeur JavaScript « null », ou « false » dans le cas contraire.

bool QJSManagedValue::isNumber() const

Renvoie « true » si le type de cet objet ` QJSManagedValue ` est ` number`, ou « false » dans le cas contraire.

bool QJSManagedValue::isObject() const

Renvoie « true » si le type de cet objet ` QJSManagedValue ` est ` object`, ou « false » dans le cas contraire.

bool QJSManagedValue::isQMetaObject() const

Renvoie « true » si cette valeur correspond à un pointeur « QMetaObject » géré dans le tas JavaScript, ou « false » dans le cas contraire.

bool QJSManagedValue::isQObject() const

Renvoie « true » si cette valeur correspond à un pointeur « QObject » géré dans le tas JavaScript, ou « false » dans le cas contraire.

bool QJSManagedValue::isRegularExpression() const

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

bool QJSManagedValue::isString() const

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

bool QJSManagedValue::isSymbol() const

Renvoie « true » si le type de cet objet ` QJSManagedValue ` est ` symbol`, ou « false » dans le cas contraire.

bool QJSManagedValue::isUndefined() const

Renvoie « true » si le type de cet objet ` QJSManagedValue ` est ` undefined`, ou « false » dans le cas contraire.

bool QJSManagedValue::isUrl() const

Renvoie « true » si cette valeur correspond à un objet Url JavaScript, ou « false » dans le cas contraire.

bool QJSManagedValue::isVariant() const

Renvoie ` true ` si cette valeur correspond à une ` QVariant ` gérée dans le tas JavaScript, ou ` false ` dans le cas contraire.

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

Renvoie la propriété « name » de cet objet « QJSManagedValue ». Si la propriété n'est pas présente sur l'objet en question, la chaîne de prototypes est parcourue.

Voir aussi ` setProperty()`.

QJSValue QJSManagedValue::property(quint32 arrayIndex) const

Renvoie la propriété stockée à l'adresse arrayIndex de cet objet QJSManagedValue. Si la propriété n'est pas trouvée sur l'objet en question, la chaîne de prototypes est parcourue.

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 également setPrototype().

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

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

Voir également property().

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

Enregistre l'value e à l'adresse arrayIndex dans cet objet QJSManagedValue. Cette opération ne peut être effectuée que sur des valeurs JavaScript de type object, et elle n'est pas recommandée si la valeur n'est pas un tableau. De plus, value doit être soit un type primitif, soit appartenir au même moteur que cette valeur.

void QJSManagedValue::setPrototype(const QJSManagedValue &prototype)

Définit le prototype de cet objet QJSManagedValue sur prototype. Une condition préalable est que prototype appartienne à la même instance QJSEngine que cet objet QJSManagedValue et soit un objet (y compris null). De plus, cet objet QJSManagedValue doit également être un objet (à l'exclusion de null), et il est interdit de créer des cycles de prototypes.

Voir également prototype().

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

Appelle l'opérateur JavaScript « === » sur ces éléments QJSManagedValue et other, puis renvoie le résultat.

Voir également equals.

bool QJSManagedValue::toBoolean() const

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

QDateTime QJSManagedValue::toDateTime() const

Si cet objet ` QJSManagedValue ` contient un objet `Date` JavaScript, renvoie un objet ` QDateTime` équivalent. Sinon, renvoie un objet non valide.

int QJSManagedValue::toInteger() const

Convertit la valeur gérée en un entier. Pour ce faire, la valeur est d’abord convertie en nombre selon les règles de la fonction ` toNumber()`, puis elle est limitée à la plage des entiers selon les règles définies pour la conversion des 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 forme d’entier, auquel cas un chemin d’exécution rapide est emprunté.

QJSValue QJSManagedValue::toJSValue() const

Copie cet objet QJSManagedValue dans un nouvel objet QJSValue. Cette opération est moins efficace que la construction par déplacement d'un objet QJSValue à partir d'un objet QJSManagedValue, mais conserve l'QJSManagedValue.

double QJSManagedValue::toNumber() const

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

QJSPrimitiveValue QJSManagedValue::toPrimitive() const

Convertit la valeur gérée en une chaîne de caractères ( QJSPrimitiveValue). Si la valeur gérée est d'un type pris en charge par la méthode ` QJSPrimitiveValue`, la valeur est copiée. Sinon, la valeur est convertie en chaîne de caractères, puis celle-ci est stockée dans ` QJSPrimitiveValue`.

const QMetaObject *QJSManagedValue::toQMetaObject() const

Si cet objet QJSManagedValue contient un pointeur QMetaObject, il le renvoie. Sinon, il renvoie nullptr.

QObject *QJSManagedValue::toQObject() const

Si cet objet « QJSManagedValue » contient un pointeur « QObject », il le renvoie. Sinon, il renvoie nullptr.

QRegularExpression QJSManagedValue::toRegularExpression() const

Si cette QJSManagedValue contient un objet d'expression régulière JavaScript, elle renvoie une QRegularExpression équivalente. Sinon, elle renvoie une 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 de caractères, celle-ci est renvoyée. Sinon, une coercition en chaîne de caractères est effectuée selon les règles JavaScript.

QUrl QJSManagedValue::toUrl() const

Si cet objet QJSManagedValue contient un objet URL JavaScript, renvoie un objet QUrl équivalent. Sinon, renvoie un objet non valide.

QVariant QJSManagedValue::toVariant() const

Copie cette adresse QJSManagedValue dans une nouvelle adresse QVariant. Cela crée également une adresse utile QVariant si la fonction QJSManagedValue::isVariant() renvoie la valeur « false ». L'adresse QVariant peut contenir tous les types pris en charge par QJSManagedValue.

QJSManagedValue::Type QJSManagedValue::type() const

Renvoie le type JavaScript de cet objet ` QJSManagedValue`.

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

La commande « move-assign » attribue un objet ` QJSManagedValue ` provenant de ` other`. Cela laisse ` other ` dans son état de construction par défaut, où il représente la valeur `undefined` et n'appartient à aucun moteur.