Função LBound

  • Artigo

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

Sintaxe

LBound(arrayname, [ dimensão ])

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

Sair Descrição
Arrayname Obrigatório. Nome da variável da matriz; segue as convenções de nomenclatura padrão para variáveis.
Dimensão 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 localizar o limite superior de uma dimensão de matriz.

O 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 Base de Opções . A base de uma matriz criada com a função Array é zero; ela não é afetada pela Base de Opções.

Matrizes para as quais as dimensões são definidas usando a cláusula To 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 a menor subscrição disponível para a dimensão indicada de uma matriz. Use a instrução Base de Opções para substituir o valor de subscrição da 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.