Retorna um Long contendo o menor subscrito disponível para a dimensão indicada de uma matriz.
Sintaxe
LBound(arrayname [, dimension ] )
A sintaxe da função LBound tem estes argumentos:
| Argumento | Descrição |
|---|---|
| nomematriz | Obrigatório. Nome da variável de matriz; Segue as convenções de nomenclatura de variáveis padrão. |
| dimensão | Opcional. Variante (longa). Número inteiro indicando o limite inferior da dimensão que é retornado. Use 1 para a primeira dimensão, 2 para a segunda e assim por diante. Se a dimensão for omitida, 1 será assumido. |
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.
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 OptionBase . A base de uma matriz criada com a função Matriz é zero; ele não é afetado pela Base de Opção.
As 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
Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). 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 o menor subscrito disponível para a dimensão indicada de uma matriz. Use a instrução Base de Opções para substituir o valor de subscrito 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.