主要内容

insert

向字典中添加条目

自 R2023b 起

    说明

    d2 = insert(d1,key,value)value 赋给 dictionary key 中的 d2。如果 key 已有对应的值,则 insert 会覆盖该值。

    d = insert(d,key,value) 等效于 d(key) = value

    示例

    d2 = insert(d1,key,value,Overwrite=tf) 指定是否覆盖与 key 对应的现有值。

    示例

    示例

    全部折叠

    创建一个包含几个键-值对组的字典。

    names = ["Unicycle" "Bicycle" "Tricycle"];
    wheels = [1 2 3];
    d = dictionary(wheels,names)
    d =
    
      dictionary (double ⟼ string) with 3 entries:
    
        1 ⟼ "Unicycle"
        2 ⟼ "Bicycle"
        3 ⟼ "Tricycle"
    

    插入一个新条目。

    d = insert(d,4,"Car")
    d =
    
      dictionary (double ⟼ string) with 4 entries:
    
        1 ⟼ "Unicycle"
        2 ⟼ "Bicycle"
        3 ⟼ "Tricycle"
        4 ⟼ "Car"
    

    创建一个包含几个键-值对组的字典。

    names = ["Unicycle" "Bicycle" "Tricycle"];
    wheels = [1 2 3];
    d = dictionary(wheels,names)
    d =
    
      dictionary (double ⟼ string) with 3 entries:
    
        1 ⟼ "Unicycle"
        2 ⟼ "Bicycle"
        3 ⟼ "Tricycle"
    

    插入新条目而不覆盖现有条目。

    d = insert(d,[2 4],["Motorcycle" "Car"],Overwrite=false)
    d =
    
      dictionary (double ⟼ string) with 4 entries:
    
        1 ⟼ "Unicycle"
        2 ⟼ "Bicycle"
        3 ⟼ "Tricycle"
        4 ⟼ "Car"
    

    输入参数

    全部折叠

    输入字典,指定为 dictionary 对象。

    键集,指定为标量或数组。key 的数据类型必须匹配或可转换为 d 中键的数据类型。key 的大小必须与 value 的大小兼容。

    值集,指定为标量或数组。value 的数据类型必须匹配或可转换为 d 中值的数据类型。key 的大小必须与 value 的大小兼容。

    覆盖现有条目的选项,指定为 truefalse10。指定值 0false 以防止 insert 覆盖现有条目。

    示例: Overwrite=false

    提示

    • 字典按元素将键映射到值,从而支持向量化查找和插入。键和值必须由相同或彼此兼容的数据类型的元素组成。要存储非标量或异构值,请使用元胞数组。

      例如,要将表作为值插入字典中:

      d = dictionary();
      t1 = table(1,2);
      t2 = table(1,2,3);
      d(["table1" "table2"]) = {t1,t2}
      d =
      
        dictionary (string ⟼ cell) with 2 entries:
      
          "table1" ⟼ {1×2 table}
          "table2" ⟼ {1×3 table}
      

    扩展功能

    全部展开

    版本历史记录

    在 R2023b 中推出

    全部展开