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 |
- Lista de todos los miembros, incluidos los miembros heredados
- QJsonObject forma parte del soporte JSON en Qt y de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QJsonObject
| Categoría | Tipos comparables |
|---|---|
| igualdad | QJsonObject |
| igualdad | QJsonValue y QJsonValueConstRef. |
Tipos públicos
| class | const_iterator |
| class | iterator |
| ConstIterator | |
| Iterator | |
(since 6.10) | const_key_value_iterator |
| key_type | |
(since 6.10) | key_value_iterator |
| mapped_type | |
| size_type |
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) |
Elementos no miembros relacionados
| 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.