Compatibilidad con JSON en Qt
Qt ofrece compatibilidad para trabajar con datos JSON. JSON es un formato para codificar datos de objetos derivado de JavaScript, pero que actualmente se utiliza ampliamente como formato de intercambio de datos en Internet.
La compatibilidad con JSON en Qt ofrece una API de C++ fácil de usar para analizar, modificar y guardar datos JSON.
Se puede encontrar más información sobre el formato de datos JSON en json.org y en el RFC 8259.
Descripción general
JSON es un formato para almacenar datos estructurados. Cuenta con seis tipos de datos básicos:
- bool
- double
- string
- array
- object
- null
Un valor puede ser de cualquiera de los tipos anteriores. Un valor booleano se representa mediante las cadenas «true» o «false» en JSON. JSON no especifica explícitamente el rango válido para los números, pero la compatibilidad en Qt se limita al rango de validez y a la precisión de los valores de tipo «double». Una cadena puede ser cualquier cadena Unicode válida. Un array es una lista de valores, y un objeto es una colección de pares clave/valor. Todas las claves de un objeto son cadenas, y un objeto no puede contener claves duplicadas.
La representación textual de JSON encierra los arreglos entre corchetes ([ ... ]) y los objetos entre llaves ({ ... }). Las entradas de los arreglos y los objetos se separan mediante comas. El separador entre claves y valores en un objeto es dos puntos (:).
Un documento JSON sencillo que codifique una persona, su edad, su dirección y sus números de teléfono podría tener el siguiente aspecto:
{
"FirstName": "John",
"LastName": "Doe",
"Age": 43,
"Address": {
"Street": "Downing Street 10",
"City": "London",
"Country": "Great Britain"
},
"Phone numbers": [
"+44 1234567",
"+44 2345678"
]
}El ejemplo anterior consiste en un objeto con 5 pares clave/valor. Dos de los valores son cadenas de caracteres, uno es un número, otro es un objeto y el último es una matriz.
Un documento JSON válido es o bien una matriz o bien un objeto, por lo que un documento siempre comienza con un corchete o una llave.
Las clases JSON
Todas las clases JSON son clases basadas en valores y compartidas implícitamente.
La compatibilidad con JSON en Qt consta de estas clases:
Véase también Guardar y cargar una partida.
Encapsula una matriz JSON | |
Forma de leer y escribir documentos JSON | |
Encapsula un objeto JSON | |
La clase `QJsonObject::const_iterator` proporciona un iterador `const` al estilo STL para `QJsonObject` | |
La clase QJsonObject::iterator proporciona un iterador no const al estilo STL para QJsonObject | |
Se utiliza para informar de errores durante el análisis sintáctico de JSON | |
Encapsula un valor en JSON |
© 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.