本文档主要介绍字典函数的语法规则,包括参数解释、函数示例等。

函数列表

类型 函数 说明
字典函数 dct_make 构建字典。
dct_update 更新字典。
dct_delete 删除字典值。
dct_keys 获取字典关键字列表。
dct_values 获取字典值列表。
dct_get 获取字典关键字的值。

dct_make

  • 函数格式
    dct_make(关键字1, 值1, 关键字2, 值2, ...)
    说明 函数中关键字和值必须成对出现。
  • 参数说明
    参数名称 参数类型 是否必填 说明
    关键字 String 字典类型的key。
    任意 字典类型的value。
  • 返回结果

    返回构建的字典。

  • 函数示例
    加工规则:
    e_set("hello", dct_make("k1","v1","k2","v2"))
    加工结果:
    hello: {"k1":"v1","k2":"v2"}

dct_update

  • 函数格式
    dct_update(字典1, 字典2)
  • 参数说明
    参数名称 参数类型 是否必填 说明
    字典1 dict 需要被更新的目标字典。
    字典2 dict 补充的新的字典信息。
  • 返回结果

    返回更新的字典。

  • 函数示例
    原始日志:
    ctx: {"k1":"v1","k2":"v2"}
    加工规则:
    e_set("hello", dct_update(v("ctx"), {"k3": "v3"}))
    加工结果:
    ctx: {"k1":"v1","k2":"v2"}
    hello: {"k1": "v1", "k2": "v2", "k3": "v3"}

dct_delete

  • 函数格式
    dct_delete(字典, 关键字1, 关键字2, ...)
  • 参数说明
    参数名称 参数类型 是否必填 说明
    字典 dict 需要被更新的目标字典。
    关键字1 String 要删除的字典值。
    关键字2 String 要删除的字典值。
  • 返回结果

    返回删除后的字典。

  • 函数示例
    原始日志:
    ctx: {"k1":"v1","k2":"v2"}
    加工规则:
    e_set("hello", dct_delete(v("ctx"), "k2"))
    加工结果:
    ctx: {"k1":"v1","k2":"v2"}
    hello: {"k1":"v1"}

dct_keys

  • 函数格式
    dct_keys(字典)
  • 参数说明
    参数名称 参数类型 是否必填 说明
    字典 dict 字典数据。
  • 返回结果

    返回获取的字典关键词列表。

  • 函数示例
    原始日志:
    ctx: {"k1":"v1","k2":"v2"}
    加工规则:
    e_set("hello", dct_keys(v("ctx")))
    加工结果:
    ctx: {"k1":"v1","k2":"v2"}
    hello: ["k1","k2"]

dct_values

  • 函数格式
    dct_values(字典)
  • 参数说明
    参数名称 参数类型 是否必填 说明
    字典 dict 字典数据。
  • 返回结果

    返回获取的字典值列表。

  • 函数示例
    原始日志:
    ctx: {"k1":"v1","k2":"v2"}
    加工规则:
    e_set("hello", dct_values(v("ctx")))
    加工结果:
    ctx: {"k1":"v1","k2":"v2"}
    hello: ["v1","v2"]

dct_get

  • 函数格式
    dct_get(字典,key,default=None)
  • 参数说明
    参数名称 参数类型 是否必填 说明
    字典 dict 字典数据。
    key 任意 要获取值的关键字。
    default 任意 没有key的情况下,返回默认值。
  • 返回结果

    返回字典关键字的值。

  • 函数示例
    • 示例1
      原始日志:
      ctx: {"k1":"v1","k2":"v2"}
      加工规则:
      e_set("hello", dct_get(v("ctx"), "k1"))
      加工结果:
      ctx: {"k1":"v1","k2":"v2"}
      hello: v1
    • 示例2:默认没有找到key,返回默认值。
      原始日志:
      ctx: {"k1":"v1","k2":"v2"}
      加工规则:
      e_set("hello", dct_get(v("ctx"), "k3",default="123"))
      加工结果:
      ctx: {"k1":"v1","k2":"v2"}
      hello: 123