Retorna um Long que contém o menor sub-descrito disponível para a dimensão indicada de um matriz.
Sintaxe
LBound ( arrayname [, dimension ] )
A sintaxe da função LBound 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 inferior 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 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:
Dim A(1 To 100, 0 To 3, -3 To 4)
da Microsoft |
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
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 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
' Declare array variables. Dim MyArray(1 To 10, 5 To 15, 10 To 20) 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.