mps.json.encode

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

全页折叠

语法

text = mps.json.encode(data)
text = mps.json.encode(data,Name,Value)

说明

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' 将包含 -Inf、NaN 和 Inf 的数组编码成 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 中的 NaN、Inf 和 -Inf 进行编码所使用的格式，指定为以逗号分隔的对组，其中包含 'NaNInfType' 和 JSON 数据类型 'string' 或 'object'。

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

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

输出参量

全部折叠

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

版本历史记录

在 R2018a 中推出

另请参阅

| |

主题