简介

字典（dictionary）是一些元素的集合。每个元素有一个称作key 的域，不同元素的key 各不相同。PIE-Engine Studio提供字典相关算法，包括但不限于获取指定键、值、键值对、键值对数目。

Dictionary

构造函数，返回一个由给定参数构建的Dictionary对象。

函数	返回值
Dictionary(dict)	Dictionary

参数	类型	说明
dict	ComputedObject|Object, optional	被转换为字典的对象。该对象可以为：1）另一个字典。2）一个键值列表。3）null

示例

dict = {'shanxi':'xian','gansu':'lanzhou','zhejiang':'hangzhou'}
dictionary1 = pie.Dictionary(dict)
print(dictionary1.getInfo())

contains

如果字典中包含给定的键，则返回True，不包含返回False。

函数	返回值
contains(key)	Bool

参数	类型	说明
key	String	要判断是否包含的键

示例

dic = pie.dictionary.PIEDictionary({"a": 1, "b": 2, "c": 3, "d": 4})
print(dic.contains('a').getInfo())

get

从字典中获取给定键的值，返回对应键的值。

函数	返回值
get(self, key)	Value

参数	类型	说明
key	String	输入键的名称

示例

args = {'a':1, 'b':2, 'c':3, 'd':4, 'e':5}
dic = pie.Dictionary(args)
print(dic.get('a').getInfo())

getArray

以数组形式返回字典指定键的值。

函数	返回值
getArray(key)	Array

参数	类型	说明
key	String	要获取值的键

示例

dic = pie.dictionary.PIEDictionary({"a":[1,2,3], "b": 2, "c": 3, "d": 4}) 
print(dic.getArray("a").getInfo())  

getNumber

从字典中获取给定键的值为Number类型的值。

函数	返回值
getNumber(key)	Number

参数	类型	说明
key	String	要获取值的键

示例

dic = pie.dictionary.PIEDictionary({"a": 1, "b": 2, "c": 3, "d": 4})
print(dic.getNumber('a').getInfo())

getString

从字典中获取给定键的值为字符串类型的值。

函数	返回值
getString(key)	String

参数	类型	说明
key	String	要获取值的键

示例

dic = pie.dictionary.PIEDictionary({'shanxi':"taiyuan",'gansu':"lanzhou",'zhejiang':"hangzhou"})
print(dic.getString('shanxi').getInfo())

keys

返回字典所有的键名称。

函数	返回值
keys(self)	List

示例

args = {'a':1, 'b':2, 'c':3, 'd':4, 'e':5}
dic = pie.Dictionary(args)
print(dic.keys().getInfo())

set

字典中增加新键值对，如果存在相同的键就覆盖更新，如果不存在则直接创建。

函数	返回值
set(key, value)	Void

参数	类型	说明
key	String	键的名称
value	String|Number|Boolean|Object|List	键对应的值

示例

dic = pie.dictionary.PIEDictionary({"a": 1, "b": 2, "c": 3, "d": 4})  
print(dic.set("b",20).getInfo())  

size

返回字典中的条目数。

函数	返回值
size()	Number

示例

dic = pie.dictionary.PIEDictionary({"a": 1, "b": 2, "c": 3, "d": 4})
print(dic.size().getInfo())

values

返回字典所有键的值。

函数	返回值
values(self)	List

示例

args = {'a':1, 'b':2, 'c':3, 'd':4, 'e':5}
dic = pie.Dictionary(args)
print(dic.values().getInfo())