QJSPrimitiveValue Class
La clase QJSPrimitiveValue opera con tipos primitivos según la semántica de JavaScript. Más información...
| Encabezado: | #include <QJSPrimitiveValue> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Qml) target_link_libraries(mytarget PRIVATE Qt6::Qml) |
| qmake: | QT += qml |
| Desde: | Qt 6.1 |
Tipos públicos
| enum | Type { Undefined, Null, Boolean, Integer, Double, String } |
Funciones públicas
| QJSPrimitiveValue() | |
| QJSPrimitiveValue(QJSPrimitiveNull null) | |
| QJSPrimitiveValue(QJSPrimitiveUndefined undefined) | |
| QJSPrimitiveValue(QJSPrimitiveValue::Type) | |
| QJSPrimitiveValue(QString value) | |
| QJSPrimitiveValue(bool value) | |
| QJSPrimitiveValue(const QVariant &value) | |
| QJSPrimitiveValue(double value) | |
| QJSPrimitiveValue(int value) | |
(since 6.4) | QJSPrimitiveValue(QMetaType type, const void *value) |
(since 6.6) const void * | constData() const |
(since 6.6) void * | data() |
(since 6.6) const void * | data() const |
| bool | equals(const QJSPrimitiveValue &other) const |
(since 6.6) QMetaType | metaType() const |
| bool | strictlyEquals(const QJSPrimitiveValue &other) const |
(since 6.6) QJSPrimitiveValue | to() const |
| bool | toBoolean() const |
| double | toDouble() const |
| int | toInteger() const |
| QString | toString() const |
| QJSPrimitiveValue::Type | type() const |
Elementos no miembros relacionados
(since 6.1) bool | operator!=(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) QJSPrimitiveValue | operator*(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) QJSPrimitiveValue | operator+(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) QJSPrimitiveValue | operator-(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) QJSPrimitiveValue | operator/(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) bool | operator<(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) bool | operator<=(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) bool | operator==(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) bool | operator>(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
(since 6.1) bool | operator>=(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs) |
Descripción detallada
QJSPrimitiveValue admite la mayoría de los tipos primitivos definidos en el estándar ECMA-262, en particular Undefined, Boolean, Number y String. Además, se puede almacenar un valor nulo de JavaScript en un QJSPrimitiveValue y, como caso especial de Number, se puede almacenar un valor entero.
Todos esos valores se almacenan de forma inmediata, sin interactuar con el montón de JavaScript. Por lo tanto, se pueden pasar objetos `QJSPrimitiveValue` entre diferentes motores de JavaScript. A diferencia de ` QJSManagedValue`, tampoco supone ningún riesgo destruir un objeto `QJSPrimitiveValue` desde un hilo distinto al que se creó. Por otro lado, QJSPrimitiveValue no contiene ninguna referencia a ningún motor de JavaScript.
QJSPrimitiveValue implementa los operadores aritméticos y de comparación de JavaScript en los tipos compatibles con la semántica de JavaScript. Los tipos se convierten de la misma forma en que lo haría el motor de JavaScript si los operadores estuvieran escritos en una expresión de JavaScript.
El tipo «Symbol» de JavaScript no es compatible, ya que su utilidad es muy limitada en lo que respecta a los operadores aritméticos y de comparación, que son el objetivo principal de QJSPrimitiveValue. En concreto, provoca una excepción cada vez que se intenta convertirlo en un número o una cadena, y no podemos lanzar excepciones sin un motor de JavaScript.
Documentación sobre los tipos de miembros
enum QJSPrimitiveValue::Type
Esta enumeración especifica los tipos que puede contener un « QJSPrimitiveValue ».
| Constante | Valor | Descripción |
|---|---|---|
QJSPrimitiveValue::Undefined | 0 | El valor «Undefined» de JavaScript. |
QJSPrimitiveValue::Null | 1 | El valor «null» de JavaScript. En realidad, no se trata de un tipo independiente de JavaScript, sino de un valor especial del tipo «Object». Dado que es muy común y se puede almacenar sin necesidad de un motor de JavaScript, sigue siendo compatible. |
QJSPrimitiveValue::Boolean | 2 | Un valor booleano de JavaScript. |
QJSPrimitiveValue::Integer | 3 | Un entero. Se trata de un caso especial del tipo «Number» de JavaScript. QJSPrimitiveValue no tiene un tipo entero propiamente dicho, pero el estándar ECMA-262 contiene reglas sobre cómo transformar un «Number» para prepararlo para ciertos operadores que solo tienen sentido con enteros, en particular los operadores de desplazamiento de bits. El tipo «Integer» de representa el resultado de dicha transformación. |
QJSPrimitiveValue::Double | 4 | Un valor «Number» de JavaScript. |
QJSPrimitiveValue::String | 5 | Un valor de tipo «String» de JavaScript. |
Documentación de las funciones de miembro
[constexpr noexcept default] QJSPrimitiveValue::QJSPrimitiveValue()
Crea un objeto QJSPrimitiveValue de tipo «Undefined».
[constexpr noexcept] QJSPrimitiveValue::QJSPrimitiveValue(QJSPrimitiveNull null)
Crea un objeto `QJSPrimitiveValue` con el valor « null » y el tipo «Null».
[constexpr noexcept] QJSPrimitiveValue::QJSPrimitiveValue(QJSPrimitiveUndefined undefined)
Crea un objeto `QJSPrimitiveValue` con el valor ` undefined ` y el tipo `Undefined`.
[delete] QJSPrimitiveValue::QJSPrimitiveValue(QJSPrimitiveValue::Type)
Crea por defecto una instancia de ` QJSPrimitiveValue`. Esta función se ha eliminado.
[noexcept] QJSPrimitiveValue::QJSPrimitiveValue(QString value)
Crea un objeto `QJSPrimitiveValue` con el valor « value » y el tipo «String».
[constexpr noexcept] QJSPrimitiveValue::QJSPrimitiveValue(bool value)
Crea un objeto `QJSPrimitiveValue` con el valor « value » y de tipo booleano.
[explicit noexcept] QJSPrimitiveValue::QJSPrimitiveValue(const QVariant &value)
Crea un objeto `QJSPrimitiveValue` a partir del contenido de ` value `, siempre que dicho contenido pueda almacenarse en `QJSPrimitiveValue`. De lo contrario, el resultado será un objeto `QJSPrimitiveValue` de tipo «Undefined».
[constexpr noexcept] QJSPrimitiveValue::QJSPrimitiveValue(double value)
Crea un objeto `QJSPrimitiveValue` con el valor « value » y del tipo `Double`.
[constexpr noexcept] QJSPrimitiveValue::QJSPrimitiveValue(int value)
Crea un objeto `QJSPrimitiveValue` con el valor ` value ` y el tipo `Integer`.
[noexcept implicit, since 6.4] QJSPrimitiveValue::QJSPrimitiveValue(QMetaType type, const void *value)
Crea un objeto `QJSPrimitiveValue` de tipo ` type` y lo inicializa con ` value ` si ` type ` puede almacenarse en `QJSPrimitiveValue`. En ese caso, ` value ` no debe ser `nullptr`. Si ` type ` no puede almacenarse, el resultado será un objeto `QJSPrimitiveValue` de tipo `Undefined`.
Ten en cuenta que debes pasar la dirección de la variable que deseas almacenar.
Por lo general, nunca es necesario utilizar este constructor; en su lugar, utilice el que toma un « QVariant ».
Esta función se introdujo en Qt 6.4.
[constexpr, since 6.6] const void *QJSPrimitiveValue::constData() const
[constexpr, since 6.6] const void *QJSPrimitiveValue::data() const
Devuelve un puntero al valor contenido como un `void*` genérico en el que no se puede escribir.
Estas funciones se introdujeron en Qt 6.6.
[constexpr, since 6.6] void *QJSPrimitiveValue::data()
Devuelve un puntero a los datos contenidos como un *void* genérico en el que se puede escribir.
Esta función se introdujo en Qt 6.6.
[constexpr] bool QJSPrimitiveValue::equals(const QJSPrimitiveValue &other) const
Realiza la operación «==» de JavaScript sobre estos enlaces: QJSPrimitiveValue y other, y devuelve el resultado.
[constexpr, since 6.6] QMetaType QJSPrimitiveValue::metaType() const
Devuelve el « QMetaType » del valor almacenado en « QJSPrimitiveValue ».
Esta función se introdujo en Qt 6.6.
[constexpr] bool QJSPrimitiveValue::strictlyEquals(const QJSPrimitiveValue &other) const
Realiza la operación «===» de JavaScript sobre estos enlaces: QJSPrimitiveValue y other, y devuelve el resultado.
[since 6.6] template <QJSPrimitiveValue::Type type> QJSPrimitiveValue QJSPrimitiveValue::to() const
Convierte el valor al formato especificado type y devuelve el resultado como un nuevo QJSPrimitiveValue.
Esta función se introdujo en Qt 6.6.
Véase también toBoolean(), toInteger(), toDouble() y toString().
[constexpr] bool QJSPrimitiveValue::toBoolean() const
Devuelve el valor convertido a un valor booleano según las reglas de JavaScript.
[constexpr] double QJSPrimitiveValue::toDouble() const
Devuelve el valor convertido a un número de JavaScript según las reglas de JavaScript.
[constexpr] int QJSPrimitiveValue::toInteger() const
Devuelve el valor convertido a un número entero de 32 bits según las reglas que aplicaría JavaScript al prepararlo para una operación de desplazamiento de bits.
QString QJSPrimitiveValue::toString() const
Devuelve el valor convertido a una cadena de JavaScript según las reglas de JavaScript.
[constexpr] QJSPrimitiveValue::Type QJSPrimitiveValue::type() const
Devuelve el tipo de ` QJSPrimitiveValue`.
Elementos no miembros relacionados
[constexpr, since 6.1] bool operator!=(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «!==» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[since 6.1] QJSPrimitiveValue operator*(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «*» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[since 6.1] QJSPrimitiveValue operator+(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «+» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[since 6.1] QJSPrimitiveValue operator-(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «-» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[since 6.1] QJSPrimitiveValue operator/(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «/» de JavaScript entre lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[constexpr, since 6.1] bool operator<(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «<» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[constexpr, since 6.1] bool operator<=(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «<=» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[constexpr, since 6.1] bool operator==(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «===» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[constexpr, since 6.1] bool operator>(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «>» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
[constexpr, since 6.1] bool operator>=(const QJSPrimitiveValue &lhs, const QJSPrimitiveValue &rhs)
Realiza la operación «>=» de JavaScript en lhs y rhs, y devuelve el resultado.
Esta función se introdujo en Qt 6.1.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.