QVariant Class
La clase QVariant funciona como una unión para los tipos de datos más comunes de Qt. Más información...
| Encabezado: | #include <QVariant> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los miembros heredados
- Miembros obsoletos
- QVariant forma parte de las clases compartidas implícitamente.
Comparaciones de QVariant
| Categoría | Tipos comparables |
|---|---|
| igualdad | QVariant |
Tipos públicos
(since 6.11) class | ConstPointer |
(since 6.11) class | ConstReference |
(since 6.11) class | Pointer |
(since 6.11) class | Reference |
Funciones públicas
| QVariant() | |
| QVariant(QChar c) | |
| QVariant(const QPersistentModelIndex &val) | |
| QVariant(const QRegularExpression &re) | |
| QVariant(const QString &val) | |
| QVariant(const QStringList &val) | |
| QVariant(const QUrl &val) | |
| QVariant(const char *val) | |
| QVariant(double val) | |
| QVariant(float val) | |
| QVariant(int val) | |
| QVariant(qlonglong val) | |
| QVariant(qulonglong val) | |
| QVariant(uint val) | |
| QVariant(QMetaType type, const void *copy = nullptr) | |
(since 6.12) | QVariant(QBitArray &&val) |
(since 6.12) | QVariant(QByteArray &&val) |
(since 6.12) | QVariant(QDateTime &&val) |
(since 6.12) | QVariant(QEasingCurve &&val) |
(since 6.12) | QVariant(QHash<QString, QVariant> &&val) |
(since 6.12) | QVariant(QJsonArray &&val) |
(since 6.12) | QVariant(QJsonDocument &&val) |
(since 6.12) | QVariant(QJsonObject &&val) |
(since 6.12) | QVariant(QJsonValue &&val) |
(since 6.12) | QVariant(QList<QVariant> &&val) |
(since 6.12) | QVariant(QLocale &&val) |
(since 6.12) | QVariant(QMap<QString, QVariant> &&val) |
(since 6.12) | QVariant(QPersistentModelIndex &&val) |
(since 6.12) | QVariant(QRegularExpression &&val) |
(since 6.12) | QVariant(QString &&val) |
(since 6.12) | QVariant(QStringList &&val) |
(since 6.12) | QVariant(QUrl &&val) |
(since 6.6) | QVariant(std::in_place_type_t<T>, Args &&... args) |
(since 6.6) | QVariant(std::in_place_type_t<T>, std::initializer_list<U> il, Args &&... args) |
| QVariant(QDate val) | |
| QVariant(QLatin1StringView val) | |
| QVariant(QLine val) | |
| QVariant(QLineF val) | |
| QVariant(QPoint val) | |
| QVariant(QPointF val) | |
| QVariant(QRect val) | |
| QVariant(QRectF val) | |
| QVariant(QSize val) | |
| QVariant(QSizeF val) | |
| QVariant(QTime val) | |
| QVariant(QUuid val) | |
| QVariant(T) | |
| QVariant(bool val) | |
| QVariant(const QBitArray &val) | |
| QVariant(const QByteArray &val) | |
| QVariant(const QDateTime &val) | |
| QVariant(const QEasingCurve &val) | |
| QVariant(const QHash<QString, QVariant> &val) | |
| QVariant(const QJsonArray &val) | |
| QVariant(const QJsonDocument &val) | |
| QVariant(const QJsonObject &val) | |
| QVariant(const QJsonValue &val) | |
| QVariant(const QList<QVariant> &val) | |
| QVariant(const QLocale &l) | |
| QVariant(const QMap<QString, QVariant> &val) | |
| QVariant(const QModelIndex &val) | |
| QVariant(const QVariant &p) | |
| QVariant(QVariant &&other) | |
| ~QVariant() | |
| bool | canConvert() const |
(since 6.0) bool | canConvert(QMetaType type) const |
| bool | canView() const |
| void | clear() |
| const void * | constData() const |
(since 6.0) bool | convert(QMetaType targetType) |
| void * | data() |
| const void * | data() const |
(since 6.6) T & | emplace(Args &&... args) |
(since 6.6) T & | emplace(std::initializer_list<U> list, Args &&... args) |
| bool | isNull() const |
| bool | isValid() const |
(since 6.0) QMetaType | metaType() const |
| void | setValue(QVariant &&value) |
| void | setValue(T &&value) |
| void | setValue(const QVariant &value) |
| void | swap(QVariant &other) |
| QBitArray | toBitArray() const |
| bool | toBool() const |
| QByteArray | toByteArray() const |
| QChar | toChar() const |
| QDate | toDate() const |
| QDateTime | toDateTime() const |
| double | toDouble(bool *ok = nullptr) const |
| QEasingCurve | toEasingCurve() const |
| float | toFloat(bool *ok = nullptr) const |
| QHash<QString, QVariant> | toHash() const |
| int | toInt(bool *ok = nullptr) const |
| QJsonArray | toJsonArray() const |
| QJsonDocument | toJsonDocument() const |
| QJsonObject | toJsonObject() const |
| QJsonValue | toJsonValue() const |
| QLine | toLine() const |
| QLineF | toLineF() const |
| QList<QVariant> | toList() const |
| QLocale | toLocale() const |
| qlonglong | toLongLong(bool *ok = nullptr) const |
| QMap<QString, QVariant> | toMap() const |
| QModelIndex | toModelIndex() const |
| QPersistentModelIndex | toPersistentModelIndex() const |
| QPoint | toPoint() const |
| QPointF | toPointF() const |
| qreal | toReal(bool *ok = nullptr) const |
| QRect | toRect() const |
| QRectF | toRectF() const |
| QRegularExpression | toRegularExpression() const |
| QSize | toSize() const |
| QSizeF | toSizeF() const |
| QString | toString() const |
| QStringList | toStringList() const |
| QTime | toTime() const |
| uint | toUInt(bool *ok = nullptr) const |
| qulonglong | toULongLong(bool *ok = nullptr) const |
| QUrl | toUrl() const |
| QUuid | toUuid() const |
| int | typeId() const |
| const char * | typeName() const |
| int | userType() const |
| T | value() const & |
| T | view() |
| QVariant & | operator=(QVariant &&other) |
| QVariant & | operator=(const QVariant &variant) |
Miembros públicos estáticos
(since 6.0) QPartialOrdering | compare(const QVariant &lhs, const QVariant &rhs) |
(since 6.7) QVariant | fromMetaType(QMetaType type, const void *copy = nullptr) |
| QVariant | fromStdVariant(const std::variant<Types...> &value) |
(since 6.6) QVariant | fromStdVariant(std::variant<Types...> &&value) |
| QVariant | fromValue(const T &value) |
(since 6.6) QVariant | fromValue(T &&value) |
Elementos no miembros relacionados
| QVariantHash | |
| QVariantList | |
| QVariantMap | |
(since 6.6) T & | get(QVariant&v) |
(since 6.6) T && | get(QVariant &&v) |
(since 6.6) const T & | get(const QVariant&v) |
(since 6.6) const T && | get(const QVariant&&v) |
(since 6.6) T * | get_if(QVariant*v) |
(since 6.6) const T * | get_if(const QVariant*v) |
| T | qvariant_cast(const QVariant&value) |
(since 6.7) T | qvariant_cast(QVariant&&value) |
| bool | operator!=(const QVariant&lhs, const QVariant&rhs) |
| QDataStream & | operator<<(QDataStream&s, const QVariant&p) |
| bool | operator==(const QVariant&lhs, const QVariant&rhs) |
| QDataStream & | operator>>(QDataStream&s, QVariant&p) |
Descripción detallada
Un objeto QVariant contiene un único valor de un único typeId() a la vez. (Algunos tipos admiten varios valores, por ejemplo, una lista de cadenas). Puedes averiguar qué tipo, T, contiene la variante, convertirlo a un tipo diferente utilizando convert(), obtener su valor mediante una de las funciones toT() (p. ej., toSize()) y comprobar si el tipo se puede convertir a un tipo concreto utilizando canConvert().
Los métodos denominados toT() (por ejemplo, toInt(), toString()) son const. Si se solicita el tipo almacenado, devuelven una copia del objeto almacenado. Si se solicita un tipo que se pueda generar a partir del tipo almacenado, toT() copia y convierte, dejando el objeto en sí sin cambios. Si se solicita un tipo que no se puede generar a partir del tipo almacenado, el resultado depende del tipo; consulta la documentación de la función para obtener más detalles.
A continuación se muestra un código de ejemplo para ilustrar el uso de QVariant:
QDataStream out("...");
QVariant v(123); // La variante contiene ahora un int
int x = v.toInt(); // x = 123
out << v; // Escribe una etiqueta de tipo y un int en out
v = QVariant(tr("hello")); // La variante ahora contiene un QString
int y = v.toInt(); // y = 0, ya que v no se puede convertir a un int
QString s = v.toString(); // s = tr("hello") (véase QObject::tr())
out << v; // Escribe una etiqueta de tipo y un QString en out
//...
QDataStream in("..."); // (abriendo el flujo escrito anteriormente)
in >> v; // Lee una variante de tipo int
int z = v.toInt(); // z = 123
qDebug("Type is %s", // prints "Type is int"
v.typeName());
v = v.toInt() + 100; // La variante ahora tiene el valor 223
v = QVariant(QStringList()); // La variante ahora contiene una QStringListIncluso puedes almacenar valores de tipo ` QList<QVariant>` y ` QMap<QString, QVariant>` en una variante, lo que te permite construir fácilmente estructuras de datos arbitrariamente complejas de tipos arbitrarios. Esto resulta muy potente y versátil, pero puede resultar menos eficiente en cuanto a memoria y velocidad que almacenar tipos específicos en estructuras de datos estándar.
QVariant también admite el concepto de valores nulos. Una variante es nula si no contiene ningún valor inicializado o si contiene un puntero nulo.
QVariant se puede ampliar para admitir otros tipos distintos de los mencionados en la enumeración « QMetaType::Type ». Consulte «Creación de tipos Qt personalizados » para obtener más detalles.
Nota sobre los tipos de interfaz gráfica de usuario
Dado que QVariant forma parte del módulo Qt Core, no puede proporcionar funciones de conversión a los tipos de datos definidos en Qt GUI, tales como QColor, QImage y QPixmap. En otras palabras, no existe la función toColor(). En su lugar, se puede utilizar la función QVariant::value() o la función de plantilla qvariant_cast(). Por ejemplo:
La conversión inversa (por ejemplo, de QColor a QVariant) es automática para todos los tipos de datos compatibles con QVariant, incluidos los tipos relacionados con la interfaz gráfica de usuario:
Uso consecutivo de canConvert() y convert()
Al utilizar « canConvert()» y « convert()» de forma consecutiva, es posible que « canConvert()» devuelva «true», pero que « convert()» devuelva «false». Esto se debe normalmente a que « canConvert()» solo indica la capacidad general de QVariant para convertir entre tipos con datos adecuados; sigue siendo posible proporcionar datos que, en realidad, no se puedan convertir.
Por ejemplo, canConvert(QMetaType::fromType<int>()) devolvería «true» al llamarse sobre un variante que contenga una cadena de caracteres porque, en principio, QVariant es capaz de convertir cadenas de números en enteros. Sin embargo, si la cadena contiene caracteres no numéricos, no se puede convertir a un entero, y cualquier intento de conversión fracasará. Por lo tanto, es importante que ambas funciones devuelvan «true» para que la conversión se realice con éxito.
Véase también QMetaType.
Documentación de funciones de miembro
[noexcept] QVariant::QVariant()
Crea una variante no válida.
[noexcept] QVariant::QVariant(QChar c)
Crea una nueva variante con un valor de tipo «char», c.
QVariant::QVariant(const QPersistentModelIndex &val)
Crea una nueva variante con un valor « QPersistentModelIndex », val.
[noexcept] QVariant::QVariant(const QRegularExpression &re)
Crea una nueva variante con el valor de la expresión regular « re ».
[noexcept] QVariant::QVariant(const QString &val)
Crea una nueva variante con un valor de cadena: val.
[noexcept] QVariant::QVariant(const QStringList &val)
Crea una nueva variante con un valor de lista de cadenas: val.
[noexcept] QVariant::QVariant(const QUrl &val)
Crea una nueva variante con el valor de la URL val.
QVariant::QVariant(const char *val)
Crea una nueva variante con el valor de cadena « val ». La variante realiza una copia profunda de « val » en « QString », suponiendo que la codificación de la entrada « val » es UTF-8.
Ten en cuenta que val se convierte a QString para almacenarlo en la variante y que QVariant::userType() devolverá QMetaType::QString para la variante.
Puedes desactivar este operador definiendo QT_NO_CAST_FROM_ASCII al compilar tus aplicaciones.
[noexcept] QVariant::QVariant(double val)
Crea una nueva variante con un valor de punto flotante: val.
[noexcept] QVariant::QVariant(float val)
Crea una nueva variante con un valor de punto flotante: val.
[noexcept] QVariant::QVariant(int val)
Crea una nueva variante con un valor entero, val.
[noexcept] QVariant::QVariant(qlonglong val)
Crea una nueva variante con un valor entero de tipo «long long», val.
[noexcept] QVariant::QVariant(qulonglong val)
Crea una nueva variante con un valor entero de tipo «unsigned long long», val.
[noexcept] QVariant::QVariant(uint val)
Crea una nueva variante con un valor entero sin signo, val.
[explicit] QVariant::QVariant(QMetaType type, const void *copy = nullptr)
Crea una variante de tipo type y la inicializa con una copia de *copy si copy no es nullptr (en cuyo caso, copy debe apuntar a un objeto de tipo type).
Ten en cuenta que debes pasar la dirección del objeto que deseas almacenar.
Por lo general, nunca tendrás que utilizar este constructor; en su lugar, utiliza QVariant::fromValue() para construir variantes a partir de los tipos de puntero representados por QMetaType::VoidStar y QMetaType::QObjectStar.
Si type no admite la construcción por copia y copy no es nullptr, la variante no será válida. Del mismo modo, si copy es nullptr y type no admite la construcción por defecto, la variante no será válida.
Véase también QVariant::fromMetaType, QVariant::fromValue() y QMetaType::Type.
[noexcept, since 6.12] QVariant::QVariant(QBitArray &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QByteArray &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QDateTime &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QEasingCurve &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QHash<QString, QVariant> &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QJsonArray &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QJsonDocument &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QJsonObject &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept(...), since 6.12] QVariant::QVariant(QJsonValue &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(CborValueStandIn)> ` es ` true`.
[noexcept, since 6.12] QVariant::QVariant(QList<QVariant> &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QLocale &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QMap<QString, QVariant> &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QPersistentModelIndex &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QRegularExpression &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QString &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QStringList &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[noexcept, since 6.12] QVariant::QVariant(QUrl &&val)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.12.
[explicit noexcept(...), since 6.6] template <typename T, typename... Args> requires if_constructible<T, Args...> QVariant::QVariant(std::in_place_type_t<T>, Args &&... args)
Crea una nueva variante que contiene un valor de tipo ` T`. El valor que contiene se inicializa con los argumentos ` std::forward<Args>(args)...`.
Este constructor se proporciona para garantizar la compatibilidad con STL/std::any.
Restricciones
Participa en la resolución de sobrecargas solo si T puede construirse a partir de args.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
Nota: Esta función es «noexcept» cuando ` is_noexcept_constructible<q20::remove_cvref_t<T>, Args...>::value ` es ` true`.
[explicit noexcept(...), since 6.6] template <
typename T,
typename U,
typename... Args
> requires if_constructible<T, std::initializer_list<U> &, Args...>
QVariant::QVariant(std::in_place_type_t<T>, std::initializer_list<U> il, Args &&... args)
Esta sobrecarga existe para admitir tipos con constructores que aceptan un ` initializer_list`. Por lo demás, su comportamiento es equivalente al de la sobrecarga ` in_place_type_t ` sin lista de inicializadores.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
Nota: Esta función es «noexcept» cuando ` is_noexcept_constructible<q20::remove_cvref_t<T>,
std::initializer_list<U> &,
Args...
>::value ` es ` true`.
[noexcept] QVariant::QVariant(QDate val)
Crea una nueva variante con un valor de fecha: val.
QVariant::QVariant(QLatin1StringView val)
Crea una nueva variante con un valor « QString » a partir de la cadena en Latin-1 que se puede consultar en val.
[noexcept(...)] QVariant::QVariant(QLine val)
Crea una nueva variante con un valor de línea de val.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(int) * 4> ` es ` true`.
[noexcept(...)] QVariant::QVariant(QLineF val)
Crea una nueva variante con un valor de línea de val.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(qreal) * 4> ` es ` true`.
[noexcept] QVariant::QVariant(QPoint val)
Crea una nueva variante con un valor puntual de val.
[noexcept(...)] QVariant::QVariant(QPointF val)
Crea una nueva variante con un valor puntual de val.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(qreal) * 2> ` es ` true`.
[noexcept(...)] QVariant::QVariant(QRect val)
Crea una nueva variante con un valor «rect» de val.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(int) * 4> ` es ` true`.
[noexcept(...)] QVariant::QVariant(QRectF val)
Crea una nueva variante con un valor rect de val.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(qreal) * 4> ` es ` true`.
[noexcept] QVariant::QVariant(QSize val)
Crea una nueva variante con un valor de tamaño de val.
[noexcept(...)] QVariant::QVariant(QSizeF val)
Crea una nueva variante con un valor de tamaño de val.
Nota: Esta función es «noexcept» cuando ` Private::FitsInInternalSize<sizeof(qreal) * 2> ` es ` true`.
[noexcept] QVariant::QVariant(QTime val)
Crea una nueva variante con un valor temporal: val.
[noexcept(...)] QVariant::QVariant(QUuid val)
Crea una nueva variante con un valor uuid, val.
Nota: Esta función es «noexcept» cuando Private::FitsInInternalSize<16> es « true ».
[delete] template <typename T, std::enable_if_t<std::disjunction_v<std::is_pointer<T>, std::is_member_pointer<T>>, bool> = false> QVariant::QVariant(T)
Crea por defecto una instancia de ` QVariant`. Esta función se ha eliminado.
[noexcept] QVariant::QVariant(bool val)
Crea una nueva variante con un valor booleano: « val ».
[noexcept] QVariant::QVariant(const QBitArray &val)
Crea una nueva variante con un valor de matriz de bits, val.
[noexcept] QVariant::QVariant(const QByteArray &val)
Crea una nueva variante con un valor de tipo «bytearray», val.
[noexcept] QVariant::QVariant(const QDateTime &val)
Crea una nueva variante con un valor de fecha y hora: val.
QVariant::QVariant(const QEasingCurve &val)
Crea una nueva variante con un valor de curva de aceleración: val.
[noexcept] QVariant::QVariant(const QHash<QString, QVariant> &val)
Crea una nueva variante con un hash de QVariants, val.
[noexcept] QVariant::QVariant(const QJsonArray &val)
Crea una nueva variante con un valor de matriz JSON: val.
QVariant::QVariant(const QJsonDocument &val)
Crea una nueva variante con un valor de documento JSON: val.
[noexcept] QVariant::QVariant(const QJsonObject &val)
Crea una nueva variante con un valor de objeto JSON: val.
[noexcept(...)] QVariant::QVariant(const QJsonValue &val)
Crea una nueva variante con un valor JSON, val.
Nota: Esta función es «noexcept» cuando Private::FitsInInternalSize<sizeof(CborValueStandIn)> es true.
[noexcept] QVariant::QVariant(const QList<QVariant> &val)
Crea una nueva variante con un valor de lista: val.
[noexcept] QVariant::QVariant(const QLocale &l)
Crea una nueva variante con un valor de configuración regional, l.
[noexcept] QVariant::QVariant(const QMap<QString, QVariant> &val)
Crea una nueva variante con un mapa de QVariants, val.
[noexcept(...)] QVariant::QVariant(const QModelIndex &val)
Crea una nueva variante con el valor de QModelIndex, val.
Nota: Esta función es «noexcept» cuando « Private::FitsInInternalSize<8 + 2 * sizeof(quintptr)> » es « true ».
QVariant::QVariant(const QVariant &p)
Crea una copia de la variante « p » pasada como argumento a este constructor.
[noexcept] QVariant::QVariant(QVariant &&other)
Crea una instancia de QVariant mediante «move», de modo que apunte al mismo objeto al que apuntaba « other ».
[noexcept] QVariant::~QVariant()
Elimina el objeto « QVariant » y el objeto que contiene.
template <typename T> bool QVariant::canConvert() const
Devuelve « true » si la variante se puede convertir al tipo de plantilla « T »; en caso contrario, devuelve «false».
Ejemplo:
QVariant v = 42;
v.canConvert<int>(); // returns true
v.canConvert<QString>(); // returns true
MyCustomStruct s;
v.setValue(s);
v.canConvert<int>(); // returns false
v.canConvert<MyCustomStruct>(); // returns trueUn ` QVariant ` que contenga un puntero a un tipo derivado de ` QObject ` también devolverá `true` en esta función si una ` qobject_cast ` al tipo de plantilla ` T ` se realizara con éxito. Ten en cuenta que esto solo funciona para las subclases de ` QObject ` que utilizan la macro ` Q_OBJECT `.
Véase también convert().
[since 6.0] bool QVariant::canConvert(QMetaType type) const
Devuelve ` true ` si el tipo de la variante se puede convertir al tipo solicitado, ` type`. Dicha conversión se realiza automáticamente al llamar a los métodos ` toInt()`, ` toBool()`, ...
Ten en cuenta que esta función solo opera sobre el tipo de la variante, no sobre su contenido. Indica si existe una ruta de conversión desde esta variante a type, no que la conversión vaya a tener éxito cuando se intente.
Esta función se introdujo en Qt 6.0.
Véase también QMetaType::canConvert().
template <typename T> bool QVariant::canView() const
Devuelve ` true ` si se puede crear una vista mutable del tipo de plantilla ` T ` sobre esta variante; en caso contrario, devuelve ` false`.
Véase también value().
void QVariant::clear()
Convierte esta variante al tipo « QMetaType::UnknownType » y libera los recursos que se estén utilizando.
[static, since 6.0] QPartialOrdering QVariant::compare(const QVariant &lhs, const QVariant &rhs)
Compara los objetos de lhs y rhs para determinar su orden.
Devuelve QPartialOrdering::Unordered si la comparación no está admitida o si los valores no están ordenados. En caso contrario, devuelve QPartialOrdering::Less, QPartialOrdering::Equivalent o QPartialOrdering::Greater si lhs es menor, igual o mayor que rhs, respectivamente.
Si las variantes contienen datos con un metatipo diferente, los valores se consideran desordenados, a menos que ambos sean de tipo numérico o puntero, en cuyo caso se aplicarán las reglas habituales de comparación numérica o de punteros.
Nota: Si se realiza una comparación numérica y al menos un valor es NaN, se devuelve QPartialOrdering::Unordered.
Si ambas variantes contienen datos del mismo metatipo, el método utilizará el método ` QMetaType::compare ` para determinar el orden de las dos variantes, lo que también puede indicar que no puede establecer un orden entre los dos valores.
Esta función se introdujo en Qt 6.0.
Véase también QMetaType::compare() y QMetaType::isOrdered().
Devuelve un puntero al objeto contenido como un *void* genérico en el que no se puede escribir.
Véase también get_if() y QMetaType.
[since 6.0] bool QVariant::convert(QMetaType targetType)
Convierte la variante al tipo solicitado, targetType. Si la conversión no se puede realizar, la variante se cambia igualmente al tipo solicitado, pero se deja en un estado nulo y vacío similar al creado por QVariant(Type).
Devuelve ` true ` si el tipo actual de la variante se ha convertido correctamente; en caso contrario, devuelve ` false`.
Un ` QVariant ` que contenga un puntero a un tipo derivado de ` QObject ` también se convertirá y devolverá `true` para esta función si una ` qobject_cast ` al tipo descrito por ` targetType ` tuviera éxito. Ten en cuenta que esto solo funciona para las subclases de ` QObject ` que utilicen la macro ` Q_OBJECT `.
Nota: la conversión de QVariants que sean nulos por no estar inicializados o por haber fallado en una conversión anterior siempre fallará, cambiando el tipo, permaneciendo nulo y devolviendo « false ».
Esta función se introdujo en Qt 6.0.
Véase también canConvert() y clear().
void *QVariant::data()
Devuelve un puntero al objeto contenido como un *void* genérico en el que se puede escribir.
Esta función desvincula el ` QVariant`. Cuando se invoca sobre un ` null-QVariant`, el ` QVariant ` no será nulo tras la llamada.
Véanse también get_if() y QMetaType.
[since 6.6] template <typename T, typename... Args> requires if_constructible<T, Args...> T &QVariant::emplace(Args &&... args)
Sustituye el objeto que contiene actualmente ` *this ` por un objeto de tipo ` T`, construido a partir de ` args... `. Si ` *this ` no era nulo, primero se destruye el objeto que contenía anteriormente. Si es posible, este método reutilizará la memoria asignada por ` QVariant`. Devuelve una referencia al objeto recién creado.
Esta función se introdujo en Qt 6.6.
[since 6.6] template <
typename T,
typename U,
typename... Args
> requires if_constructible<T, std::initializer_list<U> &, Args...>
T &QVariant::emplace(std::initializer_list<U> list, Args &&... args)
Esta sobrecarga existe para admitir tipos con constructores que toman un ` initializer_list`. Por lo demás, su comportamiento es equivalente al de la sobrecarga sin lista de inicializadores.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
[static, since 6.7] QVariant QVariant::fromMetaType(QMetaType type, const void *copy = nullptr)
Crea una variante de tipo type y la inicializa con una copia de *copy si copy no es nullptr (en cuyo caso, copy debe apuntar a un objeto de tipo type).
Ten en cuenta que debes pasar la dirección del objeto que deseas almacenar.
Por lo general, nunca es necesario utilizar este constructor; en su lugar, utilice QVariant::fromValue() para construir variantes a partir de los tipos de puntero representados por QMetaType::VoidStar y QMetaType::QObjectStar.
Si type no admite la construcción por copia y copy no es nullptr, la variante no será válida. Del mismo modo, si copy es nullptr y type no admite la construcción por defecto, la variante no será válida.
Devuelve el objeto ` QVariant ` creado tal y como se ha descrito anteriormente.
Esta función se introdujo en Qt 6.7.
Véase también QVariant::fromValue() y QMetaType::Type.
[static] template <typename... Types> QVariant QVariant::fromStdVariant(const std::variant<Types...> &value)
Devuelve un ` QVariant ` con el tipo y el valor de la variante activa de ` value`. Si el tipo activo es `std::monostate`, se devuelve un ` QVariant ` por defecto.
Nota: Con este método no es necesario registrar la variante como un metatipo de Qt, ya que el std::variant se resuelve antes de almacenarse. No obstante, los tipos de los componentes sí deben registrarse.
Véase también fromValue().
[static, since 6.6] template <typename... Types> QVariant QVariant::fromStdVariant(std::variant<Types...> &&value)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
[static] template <typename T> QVariant QVariant::fromValue(const T &value)
Devuelve un objeto ` QVariant ` que contiene una copia de ` value`. Por lo demás, se comporta exactamente igual que ` setValue()`.
Ejemplo:
MyCustomStruct s;
return QVariant::fromValue(s);Véase también setValue() y value().
[static, since 6.6] template <typename T> requires if_rvalue<T> QVariant QVariant::fromValue(T &&value)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
bool QVariant::isNull() const
Devuelve « true » si se trata de una variante nula; en caso contrario, devuelve «false».
Una variante se considera nula si no contiene ningún valor inicializado o si contiene un puntero nulo.
Nota: Este comportamiento ha cambiado con respecto a Qt 5, donde isNull() también devolvía «true» si la variante contenía un objeto de un tipo integrado con un método isNull() que devolviera «true» para ese objeto.
Véase también convert().
bool QVariant::isValid() const
Devuelve « true » si el tipo de almacenamiento de esta variante no es « QMetaType::UnknownType »; en caso contrario, devuelve « false ».
[since 6.0] QMetaType QVariant::metaType() const
Devuelve el tipo « QMetaType » del valor almacenado en la variante.
Esta función se introdujo en Qt 6.0.
void QVariant::setValue(QVariant &&value)
Mueve value a esta dirección: QVariant. Es equivalente a realizar simplemente una reasignación de value a esta dirección: QVariant.
Véase también value().
template <typename T, typename = std::enable_if_t<!std::is_same_v<std::decay_t<T>, QVariant>>> void QVariant::setValue(T &&value)
Almacena una copia de value. Si T es un tipo que QVariant no admite, se utiliza QMetaType para almacenar el valor. Se producirá un error de compilación si QMetaType no admite ese tipo.
Ejemplo:
QVariant v;
v.setValue(5);
int i = v.toInt(); // i is now 5
QString s = v.toString(); // s is now "5"
MyCustomStruct c;
v.setValue(c);
//...
MyCustomStruct c2 = v.value<MyCustomStruct>();Véase también value(), fromValue() y canConvert().
void QVariant::setValue(const QVariant &value)
Copia value en este QVariant. Equivale simplemente a asignar value a este QVariant.
[noexcept] void QVariant::swap(QVariant &other)
Intercambia esta variante con other. Esta operación es muy rápida y nunca falla.
QBitArray QVariant::toBitArray() const
Devuelve la variante como un objeto ` QBitArray ` si la variante tiene ` userType()` ` QMetaType::QBitArray`; en caso contrario, devuelve una matriz de bits vacía.
Véase también ` canConvert()` y ` convert()`.
bool QVariant::toBool() const
Devuelve la variante como un valor booleano si la variante tiene userType() Bool.
Devuelve ` true ` si la variante tiene ` userType()` ` QMetaType::Bool`, ` QMetaType::QChar`, ` QMetaType::Double`, ` QMetaType::Int`, ` QMetaType::LongLong`, ` QMetaType::UInt` o ` QMetaType::ULongLong ` y el valor es distinto de cero, o si la variante tiene el tipo ` QMetaType::QString ` o ` QMetaType::QByteArray ` y su contenido en minúsculas no es uno de los siguientes: vacío, «0» o «false»; en caso contrario, devuelve ` false`.
Véase también canConvert() y convert().
QByteArray QVariant::toByteArray() const
Devuelve la variante como un objeto ` QByteArray ` si la variante tiene ` userType()` QMetaType::QByteArray ` o ` QMetaType::QString ` (convertidos mediante ` QString::fromUtf8()`); en caso contrario, devuelve una matriz de bytes vacía.
Véanse también canConvert() y convert().
QChar QVariant::toChar() const
Devuelve la variante como un ` QChar ` si la variante tiene ` userType()` QMetaType::QChar, ` QMetaType::Int` o ` QMetaType::UInt`; en caso contrario, devuelve un ` QChar` no válido.
Véase también canConvert() y convert().
QDate QVariant::toDate() const
Devuelve la variante como un objeto ` QDate ` si la variante tiene ` userType()` QMetaType::QDate, ` QMetaType::QDateTime` o ` QMetaType::QString`; en caso contrario, devuelve una fecha no válida.
Si el parámetro ` metaType()` es ` QMetaType::QString`, se devolverá una fecha no válida si la cadena no se puede analizar como una fecha en formato ` Qt::ISODate `.
Véanse también canConvert() y convert().
QDateTime QVariant::toDateTime() const
Devuelve la variante como un objeto ` QDateTime ` si la variante tiene ` userType()` QMetaType::QDateTime, ` QMetaType::QDate` o ` QMetaType::QString`; en caso contrario, devuelve una fecha/hora no válida.
Si el valor de ` metaType()` es ` QMetaType::QString`, se devolverá una fecha/hora no válida si la cadena no se puede analizar como una fecha/hora en formato ` Qt::ISODate `.
Véase también canConvert() y convert().
double QVariant::toDouble(bool *ok = nullptr) const
Devuelve la variante como un valor de tipo «double» si la variante tiene userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt o QMetaType::ULongLong; en caso contrario, devuelve 0,0.
Si ok no es nulo: *ok se establece en true si el valor se puede convertir a un doble; en caso contrario, *ok se establece en false.
Véase también canConvert() y convert().
QEasingCurve QVariant::toEasingCurve() const
Devuelve la variante como un objeto ` QEasingCurve ` si la variante tiene un ` userType()` ` QMetaType::QEasingCurve`; en caso contrario, devuelve una curva de aceleración predeterminada.
Véase también canConvert() y convert().
float QVariant::toFloat(bool *ok = nullptr) const
Devuelve la variante como un valor de tipo «float» si la variante tiene uno de los siguientes valores: userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt o QMetaType::ULongLong; en caso contrario, devuelve 0,0.
Si ` ok ` no es nulo: ` * ` `ok ` se establece en `true` si el valor se puede convertir a `double`; en caso contrario, ` * ` `ok ` se establece en `false`.
Véase también canConvert() y convert().
QHash<QString, QVariant> QVariant::toHash() const
Devuelve la variante como un QHash<QString, QVariant> si la variante tiene metaType() QMetaType::QVariantHash. Si no es así, QVariant intentará convertir el tipo a un hash y, a continuación, lo devolverá. Esto funcionará para cualquier tipo que haya registrado un convertidor en QVariantHash o que se haya declarado como contenedor asociativo mediante Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE. Si ninguna de estas condiciones se cumple, esta función devolverá un hash vacío.
Véase también ` canConvert()` y ` convert()`.
int QVariant::toInt(bool *ok = nullptr) const
Devuelve la variante como un entero si la variante tiene userType() QMetaType::Int, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt o QMetaType::ULongLong; en caso contrario, devuelve 0.
Si ok no es nulo: *ok se establece en true si el valor se puede convertir a un int; en caso contrario, *ok se establece en false.
Advertencia: Si el valor es convertible a un ` QMetaType::LongLong ` pero es demasiado grande para representarse en un `int`, el desbordamiento aritmético resultante no se reflejará en ` ok`. Una solución sencilla es utilizar ` QString::toInt()`.
Véase también canConvert() y convert().
QJsonArray QVariant::toJsonArray() const
Devuelve la variante como un objeto de tipo « QJsonArray » si la variante tiene un valor de « userType()» QJsonArray; en caso contrario, devuelve un objeto de tipo « QJsonArray » construido por defecto.
Véanse también canConvert() y convert().
QJsonDocument QVariant::toJsonDocument() const
Devuelve la variante como un ` QJsonDocument ` si la variante tiene ` userType()` ` QJsonDocument`; en caso contrario, devuelve un ` QJsonDocument` construido por defecto.
Véase también canConvert() y convert().
QJsonObject QVariant::toJsonObject() const
Devuelve la variante como un ` QJsonObject ` si la variante tiene ` userType()` QJsonObject; en caso contrario, devuelve un ` QJsonObject` construido por defecto.
Véase también canConvert() y convert().
QJsonValue QVariant::toJsonValue() const
Devuelve la variante como un ` QJsonValue ` si la variante tiene ` userType()` ` QJsonValue`; en caso contrario, devuelve un ` QJsonValue` construido por defecto.
Véase también canConvert() y convert().
QLine QVariant::toLine() const
Devuelve la variante como un ` QLine ` si la variante tiene ` userType()` ` QMetaType::QLine`; en caso contrario, devuelve un ` QLine` no válido.
Véase también canConvert() y convert().
QLineF QVariant::toLineF() const
Devuelve la variante como un objeto ` QLineF ` si la variante tiene ` userType()` ` QMetaType::QLineF`; en caso contrario, devuelve un objeto no válido ` QLineF`.
Véase también canConvert() y convert().
QList<QVariant> QVariant::toList() const
Devuelve la variante como un ` QVariantList ` si la variante tiene ` userType()` QMetaType::QVariantList. Si no es así, ` QVariant ` intentará convertir el tipo a una lista y, a continuación, la devolverá. Esto funcionará para cualquier tipo que haya registrado un convertidor en ` QVariantList ` o que se haya declarado como un contenedor secuencial mediante ` Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE`. Si ninguna de estas condiciones se cumple, esta función devolverá una lista vacía.
Véase también canConvert() y convert().
QLocale QVariant::toLocale() const
Devuelve la variante como un ` QLocale ` si la variante tiene ` userType()` QMetaType::QLocale; en caso contrario, devuelve un ` QLocale` no válido.
Véase también canConvert() y convert().
qlonglong QVariant::toLongLong(bool *ok = nullptr) const
Devuelve la variante como un entero «long long» si la variante tiene un userType(), QMetaType::LongLong, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::QString, QMetaType::UInt o QMetaType::ULongLong; en caso contrario, devuelve 0.
Si ok es distinto de nulo: *ok se establece en true si el valor se puede convertir a int; en caso contrario, *ok se establece en false.
Véanse también canConvert() y convert().
QMap<QString, QVariant> QVariant::toMap() const
Devuelve la variante como un ` QVariantMap ` si la variante tiene ` metaType()` QMetaType::QVariantMap. Si no es así, ` QVariant ` intentará convertir el tipo a un mapa y, a continuación, lo devolverá. Esto tendrá éxito para cualquier tipo que haya registrado un convertidor en ` QVariantMap ` o que se haya declarado como un contenedor asociativo mediante ` Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE`. Si ninguna de esas condiciones se cumple, esta función devolverá un mapa vacío.
Véase también canConvert() y convert().
QModelIndex QVariant::toModelIndex() const
Devuelve la variante como un ` QModelIndex ` si la variante tiene ` userType()` ` QModelIndex`; en caso contrario, devuelve un ` QModelIndex` construido por defecto.
Véase también canConvert(), convert() y toPersistentModelIndex().
QPersistentModelIndex QVariant::toPersistentModelIndex() const
Devuelve la variante como un ` QPersistentModelIndex ` si la variante tiene un ` userType()` QPersistentModelIndex; en caso contrario, devuelve un ` QPersistentModelIndex` construido por defecto.
Véase también canConvert(), convert() y toModelIndex().
QPoint QVariant::toPoint() const
Devuelve la variante como un objeto ` QPoint ` si la variante tiene ` userType()` QMetaType::QPoint o ` QMetaType::QPointF`; en caso contrario, devuelve un objeto nulo ` QPoint`.
Véase también canConvert() y convert().
QPointF QVariant::toPointF() const
Devuelve la variante como un objeto ` QPointF ` si la variante tiene ` userType()` QMetaType::QPoint ` o ` QMetaType::QPointF`; en caso contrario, devuelve un valor nulo ` QPointF`.
Véase también canConvert() y convert().
qreal QVariant::toReal(bool *ok = nullptr) const
Devuelve la variante como un qreal si la variante tiene userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt o QMetaType::ULongLong; en caso contrario, devuelve 0,0.
Si ok no es nulo: *ok se establece en true si el valor se puede convertir a un doble; en caso contrario, *ok se establece en false.
Véanse también canConvert() y convert().
QRect QVariant::toRect() const
Devuelve la variante como un objeto ` QRect ` si la variante tiene ` userType()` QMetaType::QRect; en caso contrario, devuelve un objeto ` QRect` no válido.
Véase también canConvert() y convert().
QRectF QVariant::toRectF() const
Devuelve la variante como un objeto ` QRectF ` si la variante tiene ` userType()` QMetaType::QRect ` o ` QMetaType::QRectF`; en caso contrario, devuelve un objeto ` QRectF` no válido.
Véase también canConvert() y convert().
QRegularExpression QVariant::toRegularExpression() const
Devuelve la variante como un objeto ` QRegularExpression ` si la variante tiene ` userType()` ` QRegularExpression`; en caso contrario, devuelve un objeto vacío ` QRegularExpression`.
Véase también canConvert() y convert().
QSize QVariant::toSize() const
Devuelve la variante como un objeto ` QSize ` si la variante tiene ` userType()` ` QMetaType::QSize`; en caso contrario, devuelve un objeto no válido ` QSize`.
Véanse también canConvert() y convert().
QSizeF QVariant::toSizeF() const
Devuelve la variante como un objeto ` QSizeF ` si la variante tiene ` userType()` ` QMetaType::QSizeF`; en caso contrario, devuelve un objeto no válido ` QSizeF`.
Véase también canConvert() y convert().
QString QVariant::toString() const
Devuelve la variante como un objeto ` QString ` si la variante tiene un ` userType()` que incluya, entre otros:
QMetaType::QString, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::QDate, QMetaType::QDateTime, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QStringList, QMetaType::QTime, QMetaType::UInt o QMetaType::ULongLong.
Al llamar a QVariant::toString() sobre un variante no compatible, se devuelve una cadena vacía.
Véase también canConvert() y convert().
QStringList QVariant::toStringList() const
Devuelve la variante como un objeto ` QStringList ` si la variante tiene ` userType()` QMetaType::QStringList, ` QMetaType::QString` o ` QMetaType::QVariantList ` de un tipo que se pueda convertir a ` QString`; en caso contrario, devuelve una lista vacía.
Véase también canConvert() y convert().
QTime QVariant::toTime() const
Devuelve la variante como un objeto de tipo « QTime » si la variante tiene los valores « userType()», « QMetaType::QTime », « QMetaType::QDateTime » o « QMetaType::QString »; en caso contrario, devuelve una hora no válida.
Si el valor de ` metaType()` es ` QMetaType::QString`, se devolverá una hora no válida si la cadena no se puede analizar como una hora en formato ` Qt::ISODate `.
Véanse también canConvert() y convert().
uint QVariant::toUInt(bool *ok = nullptr) const
Devuelve la variante como un entero sin signo si la variante tiene userType() QMetaType::UInt, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QString o QMetaType::ULongLong; en caso contrario, devuelve 0.
Si ok no es nulo: *ok se establece en true si el valor se puede convertir a un unsigned int; en caso contrario, *ok se establece en false.
Advertencia: Si el valor es convertible a un ` QMetaType::ULongLong `, pero es demasiado grande para representarse en un `unsigned int`, el desbordamiento aritmético resultante no se reflejará en ` ok`. Una solución sencilla es utilizar ` QString::toUInt()`.
Véase también ` canConvert()` y ` convert()`.
qulonglong QVariant::toULongLong(bool *ok = nullptr) const
Devuelve la variante como un entero «long long» sin signo si la variante tiene metaType() QMetaType::ULongLong, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QString o QMetaType::UInt; en caso contrario, devuelve 0.
Si ok no es nulo: *ok se establece en true si el valor se puede convertir a un int; en caso contrario, *ok se establece en false.
Véase también canConvert() y convert().
QUrl QVariant::toUrl() const
Devuelve la variante como un objeto ` QUrl ` si la variante tiene ` userType()` ` QMetaType::QUrl`; en caso contrario, devuelve un objeto no válido ` QUrl`.
Véase también canConvert() y convert().
QUuid QVariant::toUuid() const
Devuelve la variante como un ` QUuid ` si la variante tiene ` metaType()` QMetaType::QUuid, ` QMetaType::QByteArray ` o ` QMetaType::QString`; en caso contrario, devuelve un ` QUuid` construido por defecto.
Véase también canConvert() y convert().
Devuelve el tipo de almacenamiento del valor almacenado en la variante. Es lo mismo que metaType().id().
Véase también metaType().
const char *QVariant::typeName() const
Devuelve el nombre del tipo almacenado en la variante. Las cadenas devueltas describen el tipo de datos de C++ utilizado para almacenar los datos: por ejemplo, «QFont », «QString » o «QVariantList ». Una variante no válida devuelve 0.
template <typename T> T QVariant::value() const &
Devuelve el valor almacenado convertido al tipo de plantilla ` T`. Llama a ` canConvert()` para averiguar si un tipo se puede convertir. Si el valor no se puede convertir, se devolverá un valor construido por defecto.
Si el tipo T es compatible con QVariant, esta función se comporta exactamente igual que toString(), toInt() etc.
Ejemplo:
QVariant v;
MyCustomStruct c;
if (v.canConvert<MyCustomStruct>())
c = v.value<MyCustomStruct>();
v = 7;
int i = v.value<int>(); // same as v.toInt()
QString s = v.value<QString>(); // same as v.toString(), s is now "7"
MyCustomStruct c2 = v.value<MyCustomStruct>(); // conversion failed, c2 is emptySi ` QVariant ` contiene un puntero a un tipo derivado de ` QObject `, entonces ` T ` puede ser de cualquier tipo ` QObject `. Si el puntero almacenado en ` QVariant ` puede ser ` qobject_cast ` a `T`, se devuelve ese resultado. De lo contrario, se devuelve ` nullptr `. Ten en cuenta que esto solo funciona para las subclases de ` QObject ` que utilizan la macro ` Q_OBJECT `.
Si el ` QVariant ` contiene un contenedor secuencial y ` T ` es ` QVariantList`, los elementos del contenedor se convertirán en ` QVariant` y se devolverán como un ` QVariantList`.
QList<int> intList = {7, 11, 42};
QVariant variant = QVariant::fromValue(intList);
if (variant.canConvert<QVariantList>()) {
QMetaSequence::Iterable iterable = variant.value<QMetaSequence::Iterable>();
// Se puede usar el bucle «for» de rango de C++11:
for (const QVariant&v: iterable) {
qDebug() << v;
}
// Se pueden utilizar iteradores:
QMetaSequence::Iterable::const_iteratorit = iterable.begin();
const QMetaSequence::Iterable::const_iteratorend = iterable.end();
for ( ; it != end;++it) {
qDebug() << *it;
}
}Véase también setValue(), fromValue(), canConvert() y Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE().
template <typename T> T QVariant::view()
Devuelve una vista mutable del tipo de plantilla « T » sobre el valor almacenado. Llama a ` canView()` para averiguar si se admite dicha vista. Si no se puede crear dicha vista, devuelve el valor almacenado convertido al tipo de plantilla ` T`. Llama a ` canConvert()` para averiguar si un tipo se puede convertir. Si el valor no se puede visualizar ni convertir, se devolverá un valor construido por defecto.
Véase también « canView()» y « Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE()».
[noexcept] QVariant &QVariant::operator=(QVariant &&other)
Asigna « other » a esta instancia de « QVariant ». .
QVariant &QVariant::operator=(const QVariant &variant)
Asigna el valor de la variante « variant » a esta variante.
Elementos no miembros relacionados
[alias] QVariantHash
Sinónimo de QHash<QString, QVariant>.
[alias] QVariantList
[alias] QVariantMap
Sinónimo de QMap<QString, QVariant>.
[since 6.6] template <typename T> T &get(QVariant &v)
[since 6.6] template <typename T> T &&get(QVariant &&v)
[since 6.6] template <typename T> const T &get(const QVariant &v)
[since 6.6] template <typename T> const T &&get(const QVariant &&v)
Si v contiene un objeto de tipo T, devuelve una referencia al objeto contenido; en caso contrario, la llamada tiene un comportamiento indefinido.
Las sobrecargas que toman un ` v ` mutable desvinculan ` v`: cuando se invocan sobre un ` null ` v con el tipo correspondiente T, ` v ` no será nulo tras la llamada.
Estas funciones se proporcionan para garantizar la compatibilidad con std::variant.
Estas funciones se introdujeron en Qt 6.6.
Véase también get_if() y data().
[noexcept, since 6.6] template <typename T> T *get_if(QVariant *v)
[noexcept, since 6.6] template <typename T> const T *get_if(const QVariant *v)
Si v contiene un objeto de tipo T, devuelve un puntero al objeto contenido; en caso contrario, devuelve nullptr.
La sobrecarga que toma un ` v ` mutable desvincula ` v`: cuando se invoca sobre un ` null ` v con un tipo coincidente T, ` v ` no será nulo tras la llamada.
Estas funciones se proporcionan para garantizar la compatibilidad con std::variant.
Estas funciones se introdujeron en Qt 6.6.
Véase también data().
template <typename T> T qvariant_cast(const QVariant &value)
Devuelve el objeto ` value ` proporcionado, convertido al tipo de plantilla ` T`.
Esta función es equivalente a ` QVariant::value()`.
Véase también QVariant::value().
[since 6.7] template <typename T> T qvariant_cast(QVariant &&value)
Devuelve el objeto ` value ` dado, convertido al tipo de plantilla ` T`.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
[noexcept] bool operator!=(const QVariant &lhs, const QVariant &rhs)
Devuelve ` false ` si ` lhs ` y ` rhs ` son iguales; en caso contrario, devuelve ` true`.
QVariant Utiliza el operador de igualdad de la función metaType() contenida para comprobar la igualdad.
Las variantes de tipos diferentes siempre se considerarán desiguales, salvo algunas excepciones:
- Si ambos tipos son numéricos (enteros y números de coma flotante), Qt comparará dichos tipos utilizando las reglas estándar de promoción de tipos de C++.
- Si un tipo es numérico y el otro es un ` QString`, Qt intentará convertir el ` QString ` a un tipo numérico equivalente y, si lo consigue, los comparará.
- Si ambas variantes contienen punteros a tipos derivados de « QObject », « QVariant » comprobará si los tipos están relacionados y apuntan al mismo objeto.
QDataStream &operator<<(QDataStream &s, const QVariant &p)
Escribe una variante p en el flujo s.
Véase también el formato de los operadores de QDataStream.
[noexcept] bool operator==(const QVariant &lhs, const QVariant &rhs)
Devuelve ` true ` si ` lhs ` y ` rhs ` son iguales; en caso contrario, devuelve ` false`.
QVariant Utiliza el operador de igualdad de la función metaType() incluida para comprobar la igualdad.
Las variantes de tipos diferentes siempre se considerarán desiguales, salvo algunas excepciones:
- Si ambos tipos son numéricos (enteros y números de coma flotante), Qt comparará dichos tipos utilizando las reglas estándar de promoción de tipos de C++.
- Si un tipo es numérico y el otro es un « QString », Qt intentará convertir el « QString » a un tipo numérico equivalente y, si lo consigue, los comparará.
- Si ambas variantes contienen punteros a tipos derivados de « QObject », « QVariant » comprobará si los tipos están relacionados y apuntan al mismo objeto.
El resultado de la función no se ve afectado por el resultado de ` QVariant::isNull`, lo que significa que dos valores pueden ser iguales incluso si uno de ellos es nulo y el otro no.
QDataStream &operator>>(QDataStream &s, QVariant &p)
Lee una variante p desde el flujo s.
Nota: Si el flujo contiene tipos que no son los integrados (véase QMetaType::Type), dichos tipos deben registrarse mediante qRegisterMetaType() o QMetaType::registerType() antes de que la variante pueda cargarse correctamente. Si se encuentra un tipo no registrado, QVariant activará el indicador de error en el flujo, detendrá el procesamiento y mostrará una advertencia. Por ejemplo, para QList<int> se mostraría lo siguiente:
QVariant::load: tipo de usuario desconocido con el nombre QList<int>
Véase también Formato de los operadores de QDataStream.
© 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.