core.base.json

xmake 提供了内置的 json 模块，基于 lua_cjson 实现，我们可以用它实现快速的在 json 和 lua table 直接相互操作。

我们可以通过 import("core.base.json") 直接导入使用。

这里也有一些例子：Json Examples

json.decode

• 从字符串解码 JSON 获取 Lua table

函数原型

API

json.decode(jsonstr: <string>)

参数说明

参数	描述
jsonstr	JSON 字符串

用法说明

直接从字符串解码 json 获取 lua table.

import("core.base.json")
local luatable = json.decode('[1,"2", {"a":1, "b":true}]')
print(luatable)

{
    1.0,
    "2",
    {
      b = true,
      a = 1.0
    }
  }

注意

如果里面有 null，可以用 json.null 来判断

json.encode

• 将 Lua table 编码为 JSON 字符串

函数原型

API

json.encode(table: <table>)

参数说明

参数	描述
table	要编码的 Lua table

用法说明

我们也可以直接对一个 lua table 进行编码。

local jsonstr = json.encode({1, "2", {a = 1}})

需要注意的是，如果需要编码 null，需要使用 json.null，例如

local jsonstr = json.encode({json.null, 1, "2", false, true})

json.loadfile

• 从文件加载 JSON 并解析为 Lua table

函数原型

API

json.loadfile(filepath: <string>)

参数说明

参数	描述
filepath	JSON 文件路径

用法说明

直接加载 json 文件，并解析成 lua table。

local luatable = json.loadfile("/tmp/xxx.json")

json.savefile

• 将 Lua table 保存为 JSON 文件

函数原型

API

json.savefile(filepath: <string>, table: <table>)

参数说明

参数	描述
filepath	要保存的 JSON 文件路径
table	要保存的 Lua table

用法说明

保存 lua table 到指定 json 文件。

json.savefile("/tmp/xxx.json", {1, {a = 1}})