Função LBound

Retorna um Long que contém o menor subscrito disponível para a dimensão indicada de uma matriz.

Sintaxe

LBound(arrayname, [ dimension ])

A sintaxe da função LBound tem estas partes:

Parte Descrição
arrayname Obrigatório. Nome da variável da matriz; segue as convenções de nomenclatura padrão para variáveis.
dimension Opcional; Variant (Long). Número inteiro indicando qual limite inferior da dimensão é retornado. Use 1 para a primeira dimensão, 2 para a segunda e assim por diante. Se dimensão for omitida, será considerado 1.

Comentários

A função LBound é usada com a função UBound para determinar o tamanho de uma matriz. Use a função UBound para encontrar o limite superior de uma dimensão de matriz.

LBound retorna os valores na tabela a seguir para uma matriz com as seguintes dimensões:

Declaração Valor de retorno
LBound(A, 1) 1
LBound(A, 2) 0
LBound(A, 3) -3

O limite inferior padrão para qualquer dimensão é 0 ou 1, dependendo da configuração da instrução Option Base . A base de uma matriz criada com a função Array é zero; ele não é afetado pela Base de Opções.

As matrizes para as quais as dimensões são definidas usando a cláusula Para em uma instrução Dim, Private, Public, ReDim ou Static podem ter qualquer valor inteiro como um limite inferior.

Exemplo

Este exemplo usa a função LBound para determinar o menor subscrito disponível para a dimensão indicada de uma matriz. Use a instrução Option Base para substituir o valor de subscrito de matriz base padrão de 0.

Dim Lower
Dim MyArray(1 To 10, 5 To 15, 10 To 20)     ' Declare array variables.
Dim AnyArray(10)
Lower = Lbound(MyArray, 1)     ' Returns 1.
Lower = Lbound(MyArray, 3)    ' Returns 10.
Lower = Lbound(AnyArray)    ' Returns 0 or 1, depending on
    ' setting of Option Base.


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.