简介

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

Dictionary

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

函数	返回值
Dictionary(dict)	Dictionary

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

var map1 = {shanxi:"xian",gansu:"lanzhou",zhejiang:"hangzhou"};
var dictionary1 = pie.Dictionary(map1);
var map2 = {shanxi:5,gansu:4,zhejiang:6};
var dictionary2 = pie.Dictionary(map2);
var map3 = {shanxi:[5,4,5,7],gansu:[6,3,5,4],zhejiang:[6,4,6,2]};
var dictionary3 = pie.Dictionary(map3);

contains

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

函数	返回值
contains(key)	Bool

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

var map1 = {shanxi:"xian",gansu:"lanzhou",zhejiang:"hangzhou"};
var dictionary1 = pie.Dictionary(map1);
var con = dictionary1.contains('zhejiang');
print(con);

fromLists

从字典中获取给定键的值，如果字典不包含给定的键，则返回defaultValue，除非它为null。

函数	返回值
fromLists(keys,values)	Dictionary

参数	类型	说明
keys	List	字典的key列表
values	List	字典的value列表

var  keys = ["sichuan","shanxi"];
var values = ["chengdu","xian"];
var dic1 = pie.Dictionary.fromLists(keys,values);
print(dic1);

get

从字典中获取给定键的值，如果字典不包含给定的键，则返回defaultValue，除非它为null。

函数	返回值
get(key)	Object

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

var map1 = {shanxi:"xian",gansu:"lanzhou",zhejiang:"hangzhou"};
var dictionary1 = pie.Dictionary(map1);
var getvalue = dictionary1.get('zhejiang');
print(getvalue); 

getArray

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

函数	返回值
pie.Dictionary.getArray(key)	Array

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

var map = {shanxi:[5,4,5,7],gansu:[6,3,5,4],zhejiang:[6,4,6,2]};
var dictionary = pie.Dictionary(map);
var getArray = dictionary.getArray('zhejiang');
print(getArray);

getNumber

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

函数	返回值
pie.Dictionary.getNumber(key)	Number

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

var map1 = {shanxi:0,gansu:1,zhejiang:2};
var dictionary1 = pie.Dictionary(map1);
var getnumber = dictionary1.getNumber('zhejiang');
print(getnumber);

getString

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

函数	返回值
pie.Dictionary.getString(key)	String

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

var map1 = {shanxi:"xian",gansu:"lanzhou",zhejiang:"hangzhou"};
var dictionary1 = pie.Dictionary(map1);
var getstring = dictionary1.getString('zhejiang');
print(getstring);

keys

以列表的形式检索字典的键，键将以自然顺序排序。

函数	返回值
keys()	List

var map2 = {shanxi:5,gansu:4,zhejiang:6};
var dictionary2 = pie.Dictionary(map2);
var keysobj = dictionary2.keys();
print(keysobj); 

size

返回字典中的条目数。

函数	返回值
size()	Number

var map2 = {shanxi:5,gansu:4,zhejiang:6};
var dictionary = pie.Dictionary(map2);
var size= dictionary.size();
print(size);

values

以列表形式返回字典的值，如果没有指定键，则所有值都将按字典键的自然顺序返回。

函数	返回值
values(keys)	List

参数	类型	说明
keys	List	要获取值的键列表

var map2 = {shanxi:5,gansu:4,zhejiang:6};
var dictionary2 = pie.Dictionary(map2);
var valuesobj = dictionary2.values();
print(valuesobj);