Devolve um Valor Longo contendo o maior índice disponível para a dimensão indicada de uma matriz.
Sintaxe
UBound(arrayname [, dimensão ] )
A sintaxe da função UBound tem estes argumentos:
| Argumento | Descrição |
|---|---|
| arrayname | Obrigatório. Nome da variável de matriz; segue as convenções de nomenclatura de variáveis padrão. |
| dimensão | Opcional. Variante (Longo). Número inteiro que indica qual o limite superior da dimensão que é devolvido. Utilize 1 para a primeira dimensão, 2 para a segunda e assim sucessivamente. Se a dimensão for omitida, é assumido 1. |
Comentários
A função UBound é utilizada com a função LBound para determinar o tamanho de uma matriz. Utilize a função LBound para encontrar o limite inferior de uma dimensão de matriz.
UBound devolve os seguintes valores para uma matriz com estas dimensões:
Dim A(1 To 100, 0 To 3, -3 To 4)
| Instrução | Valor de retorno |
|---|---|
UBound(A, 1) |
100 |
UBound(A, 2) |
3 |
UBound(A, 3) |
4 |
Exemplo
Observação
Exemplos que se seguem demonstram a utilização desta função num módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Programador na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função UBound para determinar o maior índice disponível para a dimensão indicada de uma matriz.
Dim Upper
' Declare array variables.
Dim MyArray(1 To 10, 5 To 15, 10 To 20)
Dim AnyArray(10)
Upper = UBound(MyArray, 1) ' Returns 10.
Upper = UBound(MyArray, 3) ' Returns 20.
Upper = UBound(AnyArray) ' Returns 10.