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