Função UBound

Devolve um Long contendo o maior subscrito disponível para a dimensão indicada de um matriz.

Sintaxe

UBound (nome de matriz [dimensão]

A sintaxe da função UBound tem estes argumentos:

Argumento

Descrição

nome de matriz

Obrigatório. Nome da matriz variável; segue convenções de nomeação variáveis padrão.

dimensão

Opcional. Variante (Longo). Número inteiro indicando qual a dimensão do limite superior é devolvido. Use 1 para a primeira dimensão, 2 para a segunda, e assim por diante. Se a dimensão for omitida, 1 é assumido.


Observações

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.

A UBound devolve os seguintes valores para uma matriz com estas dimensões:

Dim A(1 To 100, 0 To 3, -3 To 4)

Declaração

Valor Devolvido

UBound(A, 1)

100

UBound(A, 2)

3

UBound(A, 3)

4


Exemplo

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores 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 subscript 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.

Precisa de mais ajuda?

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×