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