Dictionary
# 简介
字典(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);
有问题,我来改改 (opens new window)
上次更新: 2022/05/15, 05:29:22