主要内容

mps.json.encode

MATLAB 数据转换为使用 MATLAB Production Server JSON 模式的 JSON 文本

说明

text = mps.json.encode(data) 用于对 MATLAB® 数据进行编码,并返回遵从 MATLAB Production Server™ JSON 模式的 JSON 文本。您可以在多个平台上使用此 JSON 文本来为 MATLAB Production Server 编码内容。

示例

text = mps.json.encode(data,Name,Value) 可针对特定输入用例,使用一个或多个名称-值对组参量来指定额外选项。例如,您可以决定采用为表示数据类型而定义的 large 还是 small 格式来对 data 进行编码。

示例

示例

全部折叠

将 3×3 幻方编码成 JSON 格式。

mps.json.encode(magic(3))
ans =
    '[[8,1,6],[3,5,7],[4,9,2]]'

使用 large 格式选项将 3×3 幻方编码成 JSON 格式。

mps.json.encode(magic(3),'Format','large')
ans =
    '{"mwdata":[8,3,4,1,5,9,6,7,2],"mwsize":[3,3],"mwtype":"double"}'

使用 'NanInfType' 选项中的 'object' 将包含 -InfNaNInf 的数组编码成 JSON 格式。

mps.json.encode([-Inf NaN Inf],'NaNInfType','object','Format','large')
ans =
    '{"mwdata":[{"mwdata":"-Inf"},{"mwdata":"NaN"},{"mwdata":"Inf"}], "mwsize":[1,3],"mwtype":"double"}'

输入参数

全部折叠

MATLAB Production Server 支持的 MATLAB 数据,指定为数值、字符、逻辑值、结构体或元胞。

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。

如果使用的是 R2021a 之前的版本,请使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: mps.json.encode(data,'Format','large')

对 MATLAB 数据进行编码所使用的格式,指定为以逗号分隔的对组,其中包含 'Format' 和格式 'small' 或 'large'。

small 格式是采用 JSON 格式的 MATLAB 数据类型的简化表示,而 large 格式则是更通用的表示。有关详细信息,请参阅MATLAB 数据类型的 JSON 表示 (MATLAB Production Server)

data 中的 NaNInf-Inf 进行编码所使用的格式,指定为以逗号分隔的对组,其中包含 'NaNInfType' 和 JSON 数据类型 'string' 或 'object'。

该选项表示格式化 text 以提高可读性,指定为以逗号分隔的对组,其中包含 'PrettyPrint' 和逻辑 'true' 或 'false'。

PrettyPrint 设置为 true 时,可以为用户提供更好的可读性。语法为 mps.json.encode(magic(3),'PrettyPrint',true)

输出参量

全部折叠

遵从 MATLAB Production Server JSON 模式的 JSON 格式文本,以字符向量形式返回。

版本历史记录

在 R2018a 中推出