En esta página

QJsonObject Class

La clase QJsonObject encapsula un objeto JSON. Más información...

Encabezado: #include <QJsonObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QJsonObject

CategoríaTipos comparables
igualdadQJsonObject
igualdadQJsonValue y QJsonValueConstRef.

Tipos públicos

Funciones públicas

QJsonObject()
QJsonObject(std::initializer_list<std::pair<QString, QJsonValue>> args)
QJsonObject(const QJsonObject &other)
QJsonObject(QJsonObject &&other)
~QJsonObject()
(since 6.10) auto asKeyValueRange() &&
(since 6.10) auto asKeyValueRange() &
(since 6.10) auto asKeyValueRange() const &&
(since 6.10) auto asKeyValueRange() const &
QJsonObject::iterator begin()
QJsonObject::const_iterator begin() const
(since 6.12) QJsonObject::const_iterator cbegin() const
(since 6.12) QJsonObject::const_iterator cend() const
QJsonObject::const_iterator constBegin() const
QJsonObject::const_iterator constEnd() const
QJsonObject::const_iterator constFind(const QString &key) const
QJsonObject::const_iterator constFind(QLatin1StringView key) const
QJsonObject::const_iterator constFind(QStringView key) const
(since 6.10) QJsonObject::const_key_value_iterator constKeyValueBegin() const
(since 6.10) QJsonObject::const_key_value_iterator constKeyValueEnd() const
bool contains(const QString &key) const
bool contains(QLatin1StringView key) const
bool contains(QStringView key) const
qsizetype count() const
bool empty() const
QJsonObject::iterator end()
QJsonObject::const_iterator end() const
QJsonObject::iterator erase(QJsonObject::iterator it)
QJsonObject::iterator find(const QString &key)
QJsonObject::iterator find(QLatin1StringView key)
QJsonObject::iterator find(QStringView key)
QJsonObject::const_iterator find(QLatin1StringView key) const
QJsonObject::const_iterator find(QStringView key) const
QJsonObject::const_iterator find(const QString &key) const
QJsonObject::iterator insert(const QString &key, const QJsonValue &value)
QJsonObject::iterator insert(QLatin1StringView key, const QJsonValue &value)
QJsonObject::iterator insert(QStringView key, const QJsonValue &value)
bool isEmpty() const
(since 6.10) QJsonObject::key_value_iterator keyValueBegin()
(since 6.10) QJsonObject::const_key_value_iterator keyValueBegin() const
(since 6.10) QJsonObject::key_value_iterator keyValueEnd()
(since 6.10) QJsonObject::const_key_value_iterator keyValueEnd() const
QStringList keys() const
qsizetype length() const
void remove(const QString &key)
void remove(QLatin1StringView key)
void remove(QStringView key)
qsizetype size() const
void swap(QJsonObject &other)
QJsonValue take(const QString &key)
QJsonValue take(QLatin1StringView key)
QJsonValue take(QStringView key)
QVariantHash toVariantHash() const
QVariantMap toVariantMap() const
QJsonValue value(const QString &key) const
QJsonValue value(QLatin1StringView key) const
QJsonValue value(QStringView key) const
QJsonObject &operator=(QJsonObject &&other)
QJsonObject &operator=(const QJsonObject &other)
QJsonValueRef operator[](const QString &key)
QJsonValue operator[](const QString &key) const
QJsonValueRef operator[](QLatin1StringView key)
QJsonValueRef operator[](QStringView key)
QJsonValue operator[](QLatin1StringView key) const
QJsonValue operator[](QStringView key) const

Miembros públicos estáticos

QJsonObject fromVariantHash(const QVariantHash &hash)
QJsonObject fromVariantMap(const QVariantMap &map)
bool operator!=(const QJsonObject &lhs, const QJsonObject &rhs)
bool operator==(const QJsonObject &lhs, const QJsonObject &rhs)

Descripción detallada

Un objeto JSON es una lista de pares clave-valor, en la que las claves son cadenas únicas y los valores se representan mediante un ` QJsonValue`.

Un QJsonObject puede convertirse a y desde un objeto ` QVariantMap`. Puedes consultar el número de pares (clave, valor) mediante las entradas ` size()`, ` insert()` y ` remove()`, e iterar sobre su contenido utilizando el patrón de iterador estándar de C++.

QJsonObject es una clase compartida implícitamente y comparte los datos con el documento a partir del cual se ha creado, siempre y cuando este no se modifique.

Puedes convertir el objeto a y desde JSON basado en texto mediante QJsonDocument.

Véase también Compatibilidad con JSON en Qt y Guardar y cargar una partida.

Documentación sobre los tipos de miembros

QJsonObject::ConstIterator

Sinónimo al estilo Qt de « QJsonObject::const_iterator ».

QJsonObject::Iterator

Sinónimo al estilo Qt de « QJsonObject::iterator ».

[since 6.10] QJsonObject::const_key_value_iterator

El typedef QJsonObject::const_key_value_iterator proporciona un iterador al estilo STL para ` QJsonObject`.

QJsonObject::const_key_value_iterator es, en esencia, lo mismo que QJsonObject::const_iterator, con la diferencia de que el operador *() devuelve un par clave/valor en lugar de un valor.

Esta definición de tipo se introdujo en Qt 6.10.

Véase también QKeyValueIterator.

QJsonObject::key_type

Definición de tipo para ` QString`. Se proporciona para garantizar la compatibilidad con la STL.

[since 6.10] QJsonObject::key_value_iterator

La definición de tipo `QJsonObject::key_value_iterator` proporciona un iterador al estilo STL para ` QJsonObject`.

QJsonObject::key_value_iterator es esencialmente igual que QJsonObject::iterator, con la diferencia de que el operador *() devuelve un par clave/valor en lugar de un valor.

Esta definición de tipo se introdujo en Qt 6.10.

Véase también QKeyValueIterator.

QJsonObject::mapped_type

Definición de tipo para ` QJsonValue`. Se proporciona para garantizar la compatibilidad con la STL.

QJsonObject::size_type

Definición de tipo para `qsizetype`. Se proporciona para garantizar la compatibilidad con la STL.

Documentación de las funciones de miembro

QJsonObject::QJsonObject()

Crea un objeto JSON vacío.

Véase también isEmpty().

QJsonObject::QJsonObject(std::initializer_list<std::pair<QString, QJsonValue>> args)

Crea una instancia de `QJsonObject` inicializada a partir de una lista de inicializació args. Por ejemplo:

QJsonObject object
{
    {"property1", 1},
    {"property2", 2}
};

[noexcept] QJsonObject::QJsonObject(const QJsonObject &other)

Crea una copia de ` other`.

Dado que QJsonObject se comparte de forma implícita, la copia es superficial siempre y cuando el objeto no se modifique.

[noexcept] QJsonObject::QJsonObject(QJsonObject &&other)

Crea un objeto QJsonObject a partir de other.

[noexcept] QJsonObject::~QJsonObject()

Destruye el objeto.

[since 6.10] auto QJsonObject::asKeyValueRange() &&

[since 6.10] auto QJsonObject::asKeyValueRange() &

[since 6.10] auto QJsonObject::asKeyValueRange() const &&

[since 6.10] auto QJsonObject::asKeyValueRange() const &

Devuelve un objeto de rango que permite iterar sobre este objeto como pares clave/valor. Por ejemplo, este objeto de rango se puede utilizar en un bucle «for» basado en rangos, en combinación con una declaración de enlace estructurado:

QJsonObject obj{
    { "something", "is" },
    { "in", "this" },
    { "object", 42 },
};

for (auto [key, value]: obj.asKeyValueRange()) {
    qDebug() << key << "->" << value;
   if (key== "object")
        value = "!"; // modificar el objeto en esta clave
}
qDebug() << obj["object"]; // QJsonValue(string, "!")

Ten en cuenta que el valor obtenido de esta forma es una referencia al valor que contiene el objeto. Concretamente, al modificar ese valor se modificará el propio objeto.

Al llamar a este método sobre valores de derecha (por ejemplo, sobre un objeto temporal creado en el inicializador de un bucle «for» con rango), el objeto quedará capturado en dicho rango.

Estas funciones se introdujeron en Qt 6.10.

Véase también QKeyValueIterator.

QJsonObject::iterator QJsonObject::begin()

Devuelve un iterador de tipo STL que apunta al primer elemento del objeto.

Véase también constBegin() y end().

QJsonObject::const_iterator QJsonObject::begin() const

Esta es una función sobrecargada.

[since 6.12] QJsonObject::const_iterator QJsonObject::cbegin() const

Devuelve un iterador const de estilo STL que apunta al primer elemento del objeto.

Esta función se introdujo en Qt 6.12.

Véase también begin() y cend().

[since 6.12] QJsonObject::const_iterator QJsonObject::cend() const

Devuelve un iterador const al estilo STL que apunta al elemento imaginario situado después del último elemento del objeto.

Esta función se introdujo en Qt 6.12.

Véase también cbegin() y end().

QJsonObject::const_iterator QJsonObject::constBegin() const

Devuelve un iterador const al estilo STL que apunta al primer elemento del objeto.

Véanse también begin() y constEnd().

QJsonObject::const_iterator QJsonObject::constEnd() const

Devuelve un iterador constante de estilo STL que apunta al elemento imaginario situado después del último elemento del objeto.

Véase también constBegin() y end().

QJsonObject::const_iterator QJsonObject::constFind(const QString &key) const

Devuelve un iterador const que apunta al elemento con la clave « key » en el mapa.

Si el mapa no contiene ningún elemento con la clave « key », la función devuelve « constEnd()».

QJsonObject::const_iterator QJsonObject::constFind(QLatin1StringView key) const

Esta es una función sobrecargada.

QJsonObject::const_iterator QJsonObject::constFind(QStringView key) const

Esta es una función sobrecargada.

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::constKeyValueBegin() const

Devuelve un iterador const al estilo STL que apunta a la primera entrada del objeto.

Esta función se introdujo en Qt 6.10.

Véase también ` keyValueBegin()`.

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::constKeyValueEnd() const

Devuelve un iterador constante al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del objeto.

Esta función se introdujo en Qt 6.10.

Véase también ` constKeyValueBegin()`.

bool QJsonObject::contains(const QString &key) const

Devuelve « true » si el objeto contiene la clave « key ».

Véase también insert(), remove() y take().

bool QJsonObject::contains(QLatin1StringView key) const

Esta es una función sobrecargada.

bool QJsonObject::contains(QStringView key) const

Esta es una función sobrecargada.

qsizetype QJsonObject::count() const

Es lo mismo que « size()».

bool QJsonObject::empty() const

Esta función se proporciona para garantizar la compatibilidad con la STL. Es equivalente a ` isEmpty()`, y devuelve ` true ` si el objeto está vacío; en caso contrario, devuelve ` false`.

QJsonObject::iterator QJsonObject::end()

Devuelve un iterador de estilo STL que apunta al elemento imaginario situado después del último elemento del objeto.

Véase también begin() y constEnd().

QJsonObject::const_iterator QJsonObject::end() const

Esta es una función sobrecargada.

QJsonObject::iterator QJsonObject::erase(QJsonObject::iterator it)

Elimina del mapa el par (clave, valor) al que apunta el iterador it y devuelve un iterador al siguiente elemento del mapa.

Véase también remove().

QJsonObject::iterator QJsonObject::find(const QString &key)

Devuelve un iterador que apunta al elemento con la clave « key » en el mapa.

Si el mapa no contiene ningún elemento con la clave key, la función devuelve end().

QJsonObject::iterator QJsonObject::find(QLatin1StringView key)

Esta es una función sobrecargada.

QJsonObject::iterator QJsonObject::find(QStringView key)

Esta es una función sobrecargada.

QJsonObject::const_iterator QJsonObject::find(QLatin1StringView key) const

Esta es una función sobrecargada.

QJsonObject::const_iterator QJsonObject::find(QStringView key) const

Esta es una función sobrecargada.

QJsonObject::const_iterator QJsonObject::find(const QString &key) const

Esta es una función sobrecargada.

[static] QJsonObject QJsonObject::fromVariantHash(const QVariantHash &hash)

Convierte el hash de variantes hash en un QJsonObject.

Las claves de hash se utilizarán como claves en el objeto JSON, y los valores de QVariant se convertirán a valores JSON.

Nota: La conversión desde QVariant no es totalmente libre de pérdidas. Consulta la documentación de QJsonValue::fromVariant() para obtener más información.

Véase también fromVariantMap(), toVariantHash() y QJsonValue::fromVariant().

[static] QJsonObject QJsonObject::fromVariantMap(const QVariantMap &map)

Convierte el mapa de variantes map en un QJsonObject.

Las claves de map se utilizarán como claves en el objeto JSON, y los valores de QVariant se convertirán a valores JSON.

Nota: La conversión desde QVariant no es totalmente sin pérdidas. Consulta la documentación de QJsonValue::fromVariant() para obtener más información.

Véanse también fromVariantHash(), toVariantMap() y QJsonValue::fromVariant().

QJsonObject::iterator QJsonObject::insert(const QString &key, const QJsonValue &value)

Inserta un nuevo elemento con la clave « key » y el valor « value ».

Si ya existe un elemento con la clave key, el valor de dicho elemento se sustituye por value.

Devuelve un iterador que apunta al elemento insertado.

Si el valor es QJsonValue::Undefined, se eliminará la clave del objeto. El iterador devuelto apuntará entonces a end().

Véase también remove(), take(), QJsonObject::iterator y end().

QJsonObject::iterator QJsonObject::insert(QLatin1StringView key, const QJsonValue &value)

Esta es una función sobrecargada.

QJsonObject::iterator QJsonObject::insert(QStringView key, const QJsonValue &value)

Esta es una función sobrecargada.

bool QJsonObject::isEmpty() const

Devuelve « true » si el objeto está vacío. Esto equivale a « size() == 0».

Véase también size().

[since 6.10] QJsonObject::key_value_iterator QJsonObject::keyValueBegin()

Devuelve un iterador de estilo STL que apunta a la primera entrada del objeto.

Esta función se introdujo en Qt 6.10.

Véase también ` keyValueEnd()`.

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::keyValueBegin() const

Devuelve un iterador constante al estilo STL que apunta a la primera entrada del objeto.

Esta función se introdujo en Qt 6.10.

Véase también ` keyValueEnd()`.

[since 6.10] QJsonObject::key_value_iterator QJsonObject::keyValueEnd()

Devuelve un iterador de estilo STL que apunta a la entrada imaginaria situada después de la última entrada del objeto.

Esta función se introdujo en Qt 6.10.

Véase también keyValueBegin().

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::keyValueEnd() const

Devuelve un iterador const al estilo STL que apunta a la entrada imaginaria situada después de la última entrada del objeto.

Esta función se introdujo en Qt 6.10.

Véase también keyValueBegin().

QStringList QJsonObject::keys() const

Devuelve una lista con todas las claves de este objeto.

La lista está ordenada alfabéticamente.

qsizetype QJsonObject::length() const

Es lo mismo que « size()».

void QJsonObject::remove(const QString &key)

Elimina « key » del objeto.

Véase también ` insert()` y ` take()`.

void QJsonObject::remove(QLatin1StringView key)

Esta es una función sobrecargada.

void QJsonObject::remove(QStringView key)

Esta es una función sobrecargada.

qsizetype QJsonObject::size() const

Devuelve el número de pares (clave, valor) almacenados en el objeto.

[noexcept] void QJsonObject::swap(QJsonObject &other)

Intercambia este objeto por other. Esta operación es muy rápida y nunca falla.

QJsonValue QJsonObject::take(const QString &key)

Elimina « key » del objeto.

Devuelve un ` QJsonValue ` que contiene el valor al que hace referencia ` key`. Si ` key ` no estaba contenido en el objeto, el ` QJsonValue ` devuelto es ` QJsonValue::Undefined`.

Véase también insert(), remove() y QJsonValue.

QJsonValue QJsonObject::take(QLatin1StringView key)

Esta es una función sobrecargada.

QJsonValue QJsonObject::take(QStringView key)

Esta es una función sobrecargada.

QVariantHash QJsonObject::toVariantHash() const

Convierte este objeto en un ` QVariantHash`.

Devuelve el hash creado.

Véase también toVariantMap().

QVariantMap QJsonObject::toVariantMap() const

Convierte este objeto en un ` QVariantMap`.

Devuelve el mapa creado.

Véase también toVariantHash().

QJsonValue QJsonObject::value(const QString &key) const

Devuelve un ` QJsonValue ` que representa el valor de la clave ` key`.

El objeto ` QJsonValue ` devuelto es ` QJsonValue::Undefined ` si la clave no existe.

Véase también ` QJsonValue ` y ` QJsonValue::isUndefined()`.

QJsonValue QJsonObject::value(QLatin1StringView key) const

Esta es una función sobrecargada.

QJsonValue QJsonObject::value(QStringView key) const

Esta es una función sobrecargada.

[noexcept] QJsonObject &QJsonObject::operator=(QJsonObject &&other)

La instrucción «Move» asigna la variable ` other ` a este objeto.

[noexcept] QJsonObject &QJsonObject::operator=(const QJsonObject &other)

Asigna « other » a este objeto.

QJsonValueRef QJsonObject::operator[](const QString &key)

Devuelve una referencia al valor de ` key`. Si no hay ningún valor con la clave ` key ` en el objeto, se crea uno con el valor ` QJsonValue::Null ` y, a continuación, se devuelve.

El valor devuelto es de tipo ` QJsonValueRef`, una clase auxiliar para ` QJsonArray ` y ` QJsonObject`. Cuando se obtiene un objeto de tipo ` QJsonValueRef`, se puede utilizar como si fuera una referencia a un ` QJsonValue`. Si se le asigna un valor, la asignación se aplicará al elemento de ` QJsonArray ` o ` QJsonObject ` del que se obtuvo la referencia.

Véase también value().

QJsonValue QJsonObject::operator[](const QString &key) const

Devuelve un objeto ` QJsonValue ` que representa el valor de la clave ` key`.

Esto hace lo mismo que ` value()`.

El objeto ` QJsonValue ` devuelto es ` QJsonValue::Undefined ` si la clave no existe.

Véase también value(), QJsonValue y QJsonValue::isUndefined().

QJsonValueRef QJsonObject::operator[](QLatin1StringView key)

Esta es una función sobrecargada.

QJsonValueRef QJsonObject::operator[](QStringView key)

Esta es una función sobrecargada.

QJsonValue QJsonObject::operator[](QLatin1StringView key) const

Esta es una función sobrecargada.

QJsonValue QJsonObject::operator[](QStringView key) const

Esta es una función sobrecargada.

Elementos no miembros relacionados

[noexcept] bool operator!=(const QJsonObject &lhs, const QJsonObject &rhs)

Devuelve « true » si el objeto « lhs » no es igual a « rhs »; en caso contrario, devuelve « false ».

[noexcept] bool operator==(const QJsonObject &lhs, const QJsonObject &rhs)

Devuelve ` true ` si el objeto ` lhs ` es igual a ` rhs`; en caso contrario, devuelve ` false `.

© 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.