CopyOnWriteArrayList.ToArray Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
ToArray() |
Retorna uma matriz que contém todos os elementos dessa lista na sequência apropriada (do primeiro ao último elemento). |
ToArray(Object[]) |
Retorna uma matriz contendo todos os elementos dessa lista na sequência apropriada (do primeiro ao último elemento); O tipo de tempo de execução da matriz retornada é o da matriz especificada. |
ToArray()
Retorna uma matriz que contém todos os elementos dessa lista na sequência apropriada (do primeiro ao último elemento).
[Android.Runtime.Register("toArray", "()[Ljava/lang/Object;", "GetToArrayHandler")]
public virtual Java.Lang.Object[] ToArray();
[<Android.Runtime.Register("toArray", "()[Ljava/lang/Object;", "GetToArrayHandler")>]
override this.ToArray : unit -> Java.Lang.Object[]
Retornos
uma matriz contendo todos os elementos nesta lista
Implementações
- Atributos
Comentários
Retorna uma matriz que contém todos os elementos dessa lista na sequência apropriada (do primeiro ao último elemento).
A matriz retornada será "segura" na medida em que nenhuma referência a ela é mantida por esta lista. (Em outras palavras, esse método deve alocar uma nova matriz). O chamador está, portanto, livre para modificar a matriz retornada.
Esse método atua como ponte entre APIs baseadas em array e baseadas em coleção.
Documentação Java para java.util.concurrent.CopyOnWriteArrayList.toArray()
.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Aplica-se a
ToArray(Object[])
Retorna uma matriz contendo todos os elementos dessa lista na sequência apropriada (do primeiro ao último elemento); O tipo de tempo de execução da matriz retornada é o da matriz especificada.
[Android.Runtime.Register("toArray", "([Ljava/lang/Object;)[Ljava/lang/Object;", "GetToArray_arrayLjava_lang_Object_Handler")]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public virtual Java.Lang.Object[] ToArray(Java.Lang.Object[] a);
[<Android.Runtime.Register("toArray", "([Ljava/lang/Object;)[Ljava/lang/Object;", "GetToArray_arrayLjava_lang_Object_Handler")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
override this.ToArray : Java.Lang.Object[] -> Java.Lang.Object[]
Parâmetros
- a
- Object[]
a matriz na qual os elementos da lista devem ser armazenados, se for grande o suficiente; caso contrário, uma nova matriz do mesmo tipo de tempo de execução será alocada para essa finalidade.
Retornos
uma matriz contendo todos os elementos nesta lista
Implementações
- Atributos
Comentários
Retorna uma matriz contendo todos os elementos dessa lista na sequência apropriada (do primeiro ao último elemento); O tipo de tempo de execução da matriz retornada é o da matriz especificada. Se a lista se encaixar na matriz especificada, ela será retornada nela. Caso contrário, uma nova matriz será alocada com o tipo de tempo de execução da matriz especificada e o tamanho dessa lista.
Se essa lista se encaixar na matriz especificada com espaço de sobra (ou seja, a matriz tiver mais elementos do que essa lista), o elemento na matriz imediatamente após o final da lista será definido como null
. (Isso é útil para determinar o tamanho dessa lista somente se o chamador souber que essa lista não contém elementos nulos.)
Como o #toArray()
método, esse método atua como ponte entre APIs baseadas em array e baseadas em coleção. Além disso, esse método permite um controle preciso sobre o tipo de tempo de execução da matriz de saída e pode, em determinadas circunstâncias, ser usado para economizar custos de alocação.
Suponha que x
seja uma lista conhecida por conter apenas cadeias de caracteres. O código a seguir pode ser usado para despejar a lista em uma matriz recém-alocada de String
:
{@code String[] y = x.toArray(new String[0]);}
Note que toArray(new Object[0])
é idêntico em função ao toArray()
.
Documentação Java para java.util.concurrent.CopyOnWriteArrayList.toArray(T[])
.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.