> Erlang中文手册 > new/1 根据给出的选项创建一个新的数组

array:new/1

根据给出的选项创建一个新的数组

用法:

new(Options :: array_opts()) -> array()

根据给出的选项创建一个新的数组。默认,数组是可扩展,并初始的大小是 0。数组的索引值开始是 0。

参数 Options 是一个单一的项或一个项列表,有一下选值:

  • N or {size, N}:N 是大于等于 0 的整数;表示初始数组的大小;跟 {fixed, true} 的作用一样。如果 N 不是一个非负的整数,该函数将以 badarg 的原因调用失败。
  • fixed or {fixed, true}:创建一个固定大小的数组。
  • {fixed, false}:创建一个可扩展的数组。
  • {default, Value}:把数组的默认值设置为 Value。

数据的选项以它们出现在列表里的顺序处理,即最后的选项具有更高的优先权。

默认值经常作为未初始的条目的值,并且一旦数组创建它们不能被改变。

创建一个大小为 100 的固定大小数组。

array:new(100).

创建一个空的、可扩展、默认值为 0 的数组。

array:new({default, 0}).

创建一个可扩展,初始大小是 10,且默认值为 -1 的数组。

array:new([{size, 10}, {fixed, false}, {default, -1}]).