Apagar instrução
Reinitializa os elementos de matrizes de tamanho fixo e libera espaço de armazenamento de matriz dinâmica.
Sintaxe
Lista de matrizes de apagamento
O argumentoarraylist necessário é uma ou mais variáveis de matriz delimitadas por vírgula a serem apagadas.
Comentários
O apagamento se comporta de forma diferente dependendo se uma matriz é de tamanho fixo (comum) ou dinâmica. O apagamento não recupera nenhuma memória para matrizes de tamanho fixo. Apagar define os elementos de uma matriz fixa da seguinte maneira:
Tipo de matriz | Efeito de Apagar em elementos de matriz fixa |
---|---|
Matriz numérica fixa | Define cada elemento como zero. |
Matriz de cadeia de caracteres fixa (comprimento de variável) | Define cada elemento como uma cadeia de caracteres de comprimento zero (""). |
Matriz de cadeia de caracteres fixa (comprimento fixo) | Define cada elemento como zero. |
Matriz Variant fixa | Define cada elemento como Vazio. |
Matriz de tipos definidos pelo usuário | Define cada elemento como se fosse uma variável separada. |
Matriz de objetos | Define cada elemento como o valor especial Nothing. |
Apagar libera a memória usada por matrizes dinâmicas. Antes que seu programa possa se referir à matriz dinâmica novamente, ele deve redeclare as dimensões da variável de matriz usando uma instrução ReDim .
Exemplo
Este exemplo usa a instrução Apagar para reinitializar os elementos de matrizes de tamanho fixo e desalocar o espaço de armazenamento de matriz dinâmica.
' Declare array variables.
Dim NumArray(10) As Integer ' Integer array.
Dim StrVarArray(10) As String ' Variable-string array.
Dim StrFixArray(10) As String * 10 ' Fixed-string array.
Dim VarArray(10) As Variant ' Variant array.
Dim DynamicArray() As Integer ' Dynamic array.
ReDim DynamicArray(10) ' Allocate storage space.
Erase NumArray ' Each element set to 0.
Erase StrVarArray ' Each element set to zero-length
' string ("").
Erase StrFixArray ' Each element set to 0.
Erase VarArray ' Each element set to Empty.
Erase DynamicArray ' Free memory used by array.
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.