Apagar instrução
Reinicializa os elementos de matrizes de tamanho fixo e liberta espaço de armazenamento de matriz dinâmica.
Sintaxe
Apagar lista dematrizes
O argumentoarraylist necessário é uma ou mais variáveis de matriz delimitadas por vírgulas a apagar.
Comentários
A opção Apagar comporta-se de forma diferente consoante uma matriz seja de tamanho fixo (comum) ou dinâmico. Apagar não recupera memória para matrizes de tamanho fixo. Apagar define os elementos de uma matriz fixa da seguinte forma:
| Tipo de matriz | Efeito de Apagar em elementos de matriz fixa |
|---|---|
| Matriz numérica fixa | Define cada elemento como zero. |
| Matriz de cadeia fixa (comprimento variável) | Define cada elemento como uma cadeia de comprimento zero (""). |
| Matriz de cadeia fixa (comprimento fixo) | Define cada elemento como zero. |
| Matriz de Variante Fixa | Define cada elemento como Vazio. |
| Matriz de tipos definidos pelo utilizador | Define cada elemento como se fosse uma variável separada. |
| Matriz de objetos | Define cada elemento como o valor especial Nada. |
Apagar liberta a memória utilizada por matrizes dinâmicas. Antes de o programa poder voltar a referir-se à matriz dinâmica, tem de voltar a declarar as dimensões da variável de matriz com uma instrução ReDim .
Exemplo
Este exemplo utiliza a instrução Apagar para reinstalar 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.