映射

Map 对象是一个 关联容器。它类似于数组或矢量 (例如 Vector)，因为可以存储一个或多个对象，但是它的优势在于使用字典系统定位对象，而不是使用数字索引。因此，您可以使用任意值（字符串、整数、日期等）作为键来插入或查找对象。（请注意，无论初始类型如何，键都会隐式转换为字符串。）

您可以访问映射中的元素，就好像映射是一个函数（例如 Map("foo") 按键 "foo" 引用元素）。您还可以使用方括号（如数组或 Vector），但仅在键的名称以下划线开头或完全是数字时才可以使用（例如 Map[123] 或 Map["_foo"]）。此外，您还可以使用 get 和 set 方法。

您可以使用 DOpusFactory.Map 方法创建一个新 Map。可以枚举映射中的键，并且它们会自动保持排序。

以下两个示例都输出以下内容：

count: 4
bird -> tweet
cat -> meow
dog -> woof
snake -> hiss

JScript 示例：

var map = DOpus.Create.Map();

map("cat") = "meow";
map("dog") = "woof";
map("bird") = "tweet";
map("snake") = "hiss";

DOpus.Output("count: " + map.count);

for (var e = new Enumerator(map); !e.atEnd(); e.moveNext())
{
 var key = e.item();
 var value = map(key);
 DOpus.Output(key + " -> " + value);
}

VBScript 示例：

Dim map, key, value
Set map = DOpus.Create.Map

map("cat") = "meow"
map("dog") = "woof"
map("bird") = "tweet"
map("snake") = "hiss"

DOpus.Output "count: " & map.count

For Each key In map
 value = map(key)
 DOpus.Output(key & " -> " & value)
Next

属性名称	返回类型	说明
count	int	返回 Map 当前所包含的元素数。
empty	bool	如果 Map 为空，则返回 True，否则返回 False。
length	int	count 的同义词。
size	int	count 的同义词。

方法名称	参数	返回类型	说明
assign	<Map:from>	none	将另一个 Map 的内容复制到此 Map。
clear	none	none	清除 Map 的内容。
erase	<variant:key>	none	如果映射中存在与指定键匹配的元素，则擦除该元素。
exists	<variant:key>	bool	如果映射中存在指定键，则返回 True。
get	<variant:key>	variant	返回指定键的值。
merge	<Map:from>	none	将另一个 Map 的内容与该 Map 合并。
set	<variant:key> <variant:value>	none	设置指定键的值。