跳到主要内容

词典操作

对词典变量进行添加、删除等操作

当前模块定义

sys:dictOperations计算与比较Action
标准模块
输入 8 · 输出 2 · 枚举 1

输入参数

  • 操作类型typeEnum必填
    填写 固定输入默认 setOriginValue
    11 个选项取值、设置值 (文本类型、设置值 (变量原始类型
    取值get
    设置值 (文本类型set
    设置值 (变量原始类型默认setOriginValue
    删除一项remove
    清空clear
    获取键(Key)列表keyList
    获取值列表valueList
    翻转键值reverse
    查询字符串转换为词典(name1=value1&name2=value2...queryStringToDict
    词典转换为查询字符串dictToQueryString
    词典转换为查询字符串(不对键和值进行URL编码dictToQueryStringNoEncode
  • 词典dictDict可选

    要操作的词典变量

    填写 仅变量条件 排除:queryStringToDict
  • 查询字符串queryStringText可选

    要解析的查询字符串

    填写 输入或变量条件 仅:queryStringToDict
  • keyText可选

    要操作元素的键值。

    填写 输入或变量条件 仅:get, set, remove, setOriginValue
  • valueText可选

    要保存的内容

    填写 输入或变量条件 仅:set, setOriginValue
  • 键不存在时返回空值returnEmptyIfKeyNotExistBoolean可选

    此时不作为失败处理

    填写 固定输入条件 仅:get默认 false
  • 忽略键的大小写ignoreCaseBoolean可选
    填写 固定输入条件 仅:set, get, remove, setOriginValue默认 false
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 false

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 结果valueAny

    操作后的输出(取的元素值、键列表、值列表等)

    条件 仅:get, keyList, valueList, reverse, queryStringToDict, dictToQueryString, dictToQueryStringNoEncode

对词典类型变量进行信息提取或数据处理。

词典操作

对词典变量进行添加、删除等操作
操作类型
词典
 
要操作的词典变量
 
要操作元素的键值。
 
要保存的内容
是否成功
-- 选择变量 --
操作是否成功
步骤注释
 

参数

【词典】要操作的词典变量。

【操作类型】要进行的操作。可选值为:

  • 取值:读取词典中某个键(Key)对应的值(Value)。

  • 设置值(文本类型):设置词典变量中某个键对应的值。其它类型的内容在保存时会自动转换成文本类型。

  • 设置值(变量原始类型):设置词典中某个键对应的值,在保存时不更改其类型。

  • 注意:如果值保存的是一个引用类型的对象(如列表/词典/c#类的实例等,而不是数字/文本/布尔这种简单的值类型),那么值中指向的内容可能是会变化的。例如,保存列表变量到词典的某个值以后,如果列表增加或删除了项,那么词典中的这个值也会对应发生变化,因为它们都是同一个内存对象的引用。请参考此示例动作

  • 删除值:从词典变量中去除键值对。

  • 获取键列表:将词典所有键(Key)组成一个文本列表返回。

  • 获取值列表:将词典的所有值(Value)构成一个文本列表返回。

  • 翻转键-值:生成一个新的词典对象输出到“结果”中,将原词典中的每个键值对的键转换为值,值转换为键。此时原词典每个键的值也必须是文本类型,而且不能含有重复的值。(1.5.3版本增加)

  • 查询字符串转换为词典。将name1=value1&name2=value2&name3=value3形式的查询字符串(与网址中的查询字符串格式一致),转换为词典类型,输出到【结果】参数中。(1.9.15 版本增加)

  • 词典转换为查询字符串。将词典值转换为name1=value1&name2=value2&name3=value3形式的查询字符串,输出到【结果】参数中。(1.9.15 版本增加)

【键】要操作的数据项索引名。

【值】要存到指定键(索引名)下的值。

【忽略键的大小写】读写数据的时候,是否忽略大小写。

输出

【结果】处理结果,依据“操作类型”结果内容不同:

  • “取值”:返回指定键对应的值。
  • “获取键列表”:返回所有键的列表。
  • “获取值列表”:返回所有值的列表。

【是否成功】操作是否成功。

示例动作

更新历史

  • 1.5.3 增加“翻转键值”操作类型。
  • 1.9.11 设置值增加保持原有类型的操作。
  • 1.9.15 增加词典与查询字符串之间的转换功能。

更新于