Decodificar JSON en tablas

La decodificación convierte una cadena JSON en un valor de Lua con el que puede trabajar. El punto de entrada es json.decode(text).

Si el JSON de nivel superior es un objeto, obtiene una tabla de Lua con claves de cadena; si es un array, obtiene una tabla con índices numéricos.

Un objeto JSON decodificado se comporta como cualquier tabla de Lua. Acceda a sus valores mediante la notación de punto o de corchetes.

Las claves que no son identificadores válidos de Lua, como las que contienen espacios, requieren la sintaxis de corchetes.

Un array JSON se decodifica en una tabla secuencial de Lua indexada desde 1. Puede recorrerla con ipairs o con un bucle numérico.

Recuerde que los arrays de Lua empiezan en el índice 1, no en 0.

Los números JSON se decodifican como números de Lua, y true/false de JSON se decodifican como valores booleanos de Lua.

Después de decodificarlos, puede utilizarlos directamente en operaciones aritméticas o condicionales.

JSON null es complicado porque Lua nil elimina una clave de una tabla. Las bibliotecas gestionan este caso de distintas formas.

dkjson decodifica null en un valor centinela, json.null, para que la clave siga existiendo. Compárelo con ese valor para detectar los valores null.

A menudo, el JSON se encuentra en un archivo. Lea todo el archivo en una cadena y después decodifíquela.

Este patrón es habitual para cargar configuraciones o estados de partidas guardados.

El decode de dkjson devuelve hasta tres valores: el resultado decodificado, la posición en la que se detuvo el análisis y un mensaje de error.

Si la operación tiene éxito, el resultado no es nil; si falla, es nil y el tercer valor explica el motivo.

No confíe nunca en el JSON externo. Compruebe siempre el resultado antes de utilizarlo para evitar que una carga mal formada bloquee su programa.

lua-cjson funciona de forma similar, pero genera un error cuando recibe una entrada no válida en lugar de devolverlo. Envuélvalo en pcall para mayor seguridad.

cjson es más rápido, algo importante cuando se analizan grandes volúmenes de datos.

Si lee una clave que no estaba presente en el JSON, Lua simplemente devuelve nil. Es normal y no genera un error.

Utilice un valor alternativo con or para proporcionar valores predeterminados a los campos opcionales.

Tanto un objeto JSON vacío {} como un array vacío [] se decodifican en una tabla de Lua vacía. Después de la decodificación no puede saber cuál de los dos era.

Esto importa principalmente al volver a codificar; tenga presente esa ambigüedad en los recorridos de ida y vuelta.

Compruebe lo que ha aprendido sobre la decodificación de JSON.

La decodificación convierte el texto JSON en tablas de Lua: los objetos se convierten en tablas con claves de cadena y los arrays, en secuencias indexadas desde 1.

Valide siempre el resultado, gestione null mediante el valor centinela de la biblioteca y recuerde que las claves ausentes son simplemente nil. A continuación, volverá a codificar tablas de Lua en JSON.