Devolve um valorLongo (tipo de dados longo: tipo de dados fundamental que contém números inteiros grandes. Uma variável do tipo Longo é armazenada como um número de 32 bits que varia entre -2.147.483.648 e 2.147.483.647.) que contém o índice maior disponível para a dimensão indicada de uma matriz (matriz: variável que contém um número finito de elementos com um nome e um tipo de dados comuns. Cada elemento de uma matriz é identificado por um número de índice exclusivo. As alterações efectuadas num elemento de uma matriz não afectam os outros elementos.).
Sintaxe
UBound(nomedamatriz [, dimensão ] )
A sintaxe da função UBound tem os seguintes argumentos:
Observações
A função UBound é utilizada com a função LBound para determinar o tamanho de uma matriz. Utilize a função UBound para localizar o limite inferior da dimensão de uma matriz.
A função UBound devolve os seguintes valores para uma matriz com as seguintes dimensões:
Dim A(1 To 100, 0 To 3, -3 To 4)
| Instrução |
Valor Devolvido |
UBound(A, 1) |
100 |
UBound(A, 2) |
3 |
UBound(A, 3) |
4 |
Exemplo
Nota Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.
Este exemplo utiliza a função UBound para determinar o índice maior disponível da 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.