主要内容

writedictionary

将字典写入文件

自 R2024b 起

    说明

    writedictionary(d,filename) 将字典 d 的内容写入具有 filename 指定的名称和扩展名的文件。例如,当 filename 中的文件扩展名指定为 .json 时,writedictionary 函数会将输入字典写入 JSON 文件。

    示例

    writedictionary(d,filename,Name=Value) 使用一个或多个名称-值参量指定选项。例如,您可以通过调用 writedictionary(d,filename,FileType="json") 将输入字典的内容导出为 JSON 文件,而不考虑 filename 中指定的文件扩展名。

    示例

    示例

    全部折叠

    创建一个字典并将其写入 JSON 文件。

    wheels = [1 2 3];
    names = ["Unicycle" "Bicycle" "Tricycle"];
    d = dictionary(names,wheels);
    writedictionary(d,"vehicles.json");

    显示创建的文件。

    type vehicles.json
    {
        "Unicycle": 1.0,
        "Bicycle": 2.0,
        "Tricycle": 3.0
    }
    

    创建一个字典并将其写入 JSON 文件(不带缩进)。

    wheels = [1 2 3];
    names = ["Unicycle" "Bicycle" "Tricycle"];
    d = dictionary(names,wheels);
    writedictionary(d,"vehicles.json",PrettyPrint=false);

    显示创建的文件。

    type vehicles.json
    {"Unicycle":1.0,"Bicycle":2.0,"Tricycle":3.0}
    

    输入参数

    全部折叠

    输入字典,指定为 MATLAB 字典。字典是将数据存储为的映射,这些值可以使用对应的唯一来访问。每对键和值构成一个条目。有关字典的详细信息,请参阅 dictionary

    在创建 JSON 文件时,writedictionary 将缺失值作为 null 值写入,将 NaN 值作为 nullNaN 值写入,具体取决于 PreserveInfAndNaN 名称-值参量。

    要写入的文件的名称,指定为字符串标量或字符向量。如果 filename 不存在,则写入函数会创建该文件。如果 filename 是现有文件,则该函数会覆盖它。

    根据您写入的位置,filename 可以采用以下形式之一。

    位置

    形式

    当前文件夹

    要写入当前文件夹,请在 filename 中指定文件名。

    示例:"myFile.json"

    其他文件夹

    要写入一个并非当前文件夹的文件夹,请在 filename 中指定完整或相对路径名称。

    示例:"C:\myFolder\myFile.json"

    示例:"myFolder\myFile.json"

    远程位置

    要写入远程位置,请指定以下形式的统一资源定位器 (URL):

    scheme_name://path_to_file/my_file.ext

    根据远程位置,scheme_name 可以是下表中的值之一。

    远程位置scheme_name
    Amazon S3™s3
    Windows Azure® Blob 存储wasb, wasbs
    HDFS™hdfs

    有关详细信息,请参阅处理远程数据

    示例:"s3://bucketname/path_to_file/my_file.json"

    名称-值参数

    全部折叠

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

    示例: writedictionary(d,filename,PreserveInfandNaN=false) 将所有 InfNaN 值作为 JSON null 值写入。

    文件类型,指定为以下值之一:

    • "auto" - 自动检测要基于 filename 中指定的扩展名写入的文件格式。

    • "json" - 将字典的内容导出为 JSON 文件,而不考虑 filename 中指定的文件扩展名。

    如果您在 filename 中指定的文件扩展名不是 .json,则可以将 FileType 指定为 "json" 以将输入字典的内容作为 JSON 写入。

    在输出文件中缩进文本,指定为数值或逻辑值 1 (true) 或 0 (false)。如果您将该参量指定为 true,则 writedictionary 会写入缩进四个空格的 JSON 文本。如果您将该参量指定为 false,则 writedictionary 会写入不带空格或换行符的 JSON 文本。

    在输出 JSON 文件中保留 InfNaN 值,指定为数值或逻辑值 1 (true) 或 0 (false)。将此参量指定为 false 以将所有 InfNaN 值作为 JSON null 值写入。

    版本历史记录

    在 R2024b 中推出