En esta página

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.

QJsonArray

Encapsula una matriz JSON

QJsonDocument

Forma de leer y escribir documentos JSON

QJsonObject

Encapsula un objeto JSON

QJsonObject::const_iterator

La clase `QJsonObject::const_iterator` proporciona un iterador `const` al estilo STL para `QJsonObject`

QJsonObject::iterator

La clase QJsonObject::iterator proporciona un iterador no const al estilo STL para QJsonObject

QJsonParseError

Se utiliza para informar de errores durante el análisis sintáctico de JSON

QJsonValue

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.