Retorna um Long que contém a maior subscrição disponível para a dimensão indicada de um matriz.
Sintaxe
UBound ( arrayname [, dimension ] )
A sintaxe da função UBound tem esses argumentos:
|
Argumento |
Descrição |
|
Arrayname |
Obrigatório. Nome da matriz variável; segue convenções de nomenclatura de variável padrão. |
|
dimensão |
Opcional. Variant (Long). Número inteiro indicando qual limite superior da dimensão é retornado. Use 1 para a primeira dimensão, 2 para o segundo e assim por diante. Se a dimensão for omitida, 1 será assumida. |
Comentários
A função UBound é usada com a função LBound para determinar o tamanho de uma matriz. Use a função LBound para localizar o limite inferior de uma dimensão de matriz.
UBound retorna os seguintes valores para uma matriz com estas dimensões:
Dim A(1 To 100, 0 To 3, -3 To 4)
|
da Microsoft |
Valor de retorno |
|
UBound(A, 1) |
100 |
|
UBound(A, 2) |
3 |
|
UBound(A, 3) |
4 |
Exemplo
Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Este exemplo usa a função UBound para determinar a maior subscrição 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.