返回一个包含此 set 中所有元素的数组;返回数组的运行时类型是指定数组的类型。如果指定的数组能容纳该 set,则它将在其中返回。否则,将分配一个具有指定数组的运行时类型和此 set 大小的新数组。
如果指定的数组能容纳此 set,并有剩余的空间(即该数组的元素比此 set 多),那么会将列表中紧接该 set 尾部的元素设置为 null。(只有在调用者知道此 set 不包含任何 null 元素时才能用此方法确定此 set 的长度)。
如果此 set 对其迭代器返回的元素的顺序作出了某些保证,那么此方法也必须按相同的顺序返回这些元素。
像 toarray()
方法一样,此方法充当基于数组的 api 与基于 collection 的 api 之间的桥梁。更进一步说,此方法允许对输出数组的运行时类型上进行精确控制,在某些情况下,可以用来节省分配开销。
假定 x 是只包含字符串的一个已知 set。以下代码用来将该 set 转储到一个新分配的 string 数组:
string[] y = x.toarray(new string[0]);
注意,toarray(new object[0]) 和 toarray() 在功能上是相同的。
- 指定者:
- 接口
collection
中的 toarray
- 参数:
a
- 存储此 set 中元素的数组(如果其足够大);否则将为此分配一个具有相同运行时类型的新数组。
- 返回:
- 包含此 set 中所有元素的数组
- 抛出:
arraystoreexception
- 如果指定数组的运行时类型不是此 set 中所有元素的运行时类型的超类型
nullpointerexception
- 如果指定的数组为 null