Devolve um Valor Longo contendo o menor índice disponível para a dimensão indicada de um matriz.
Sintaxe
LBound ( arrayname [, dimensão ] )
A sintaxe da função LBound tem estes argumentos:
Argumento |
Descrição |
arrayname |
Obrigatório. Nome da matriz variável; segue as convenções de nomenclatura de variáveis padrão. |
dimensão |
Opcional. Variante (Longo). Número inteiro que indica qual é o limite inferior da dimensão que é devolvido. Utilize 1 para a primeira dimensão, 2 para a segunda e assim sucessivamente. Se a dimensão for omitida, é assumido 1. |
Observações
A função LBound é utilizada com a função UBound para determinar o tamanho de uma matriz. Utilize a função UBound para encontrar o limite superior de uma dimensão de matriz.
LBound devolve os valores na tabela seguinte para uma matriz com as seguintes dimensões:
Dim A(1 To 100, 0 To 3, -3 To 4)
Declaração |
Valor Devolvido |
LBound(A, 1) |
1 |
LBound(A, 2) |
0 |
LBound(A, 3) |
-3 |
O limite inferior predefinido para qualquer dimensão é 0 ou 1, consoante a definição da instrução Basede Opções. A base de uma matriz criada com a função Matriz é zero; não é afetada pela Base de Opções.
As matrizes para as quais as dimensões são definidas com a cláusula To numa instrução Dim, Private, Public, ReDim ou Static podem ter qualquer valor inteiro como um limite inferior.
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 LBound para determinar o menor inferior à linha disponível para a dimensão indicada de uma matriz. Utilize a instrução Base de Opções para substituir o valor inferior à linha de matriz base predefinido 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.