Devolve um valor Longo (tipo de dados longo: tipo de dados fundamental que contém números inteiros grandes. Uma variável do tipo Longo é armazenada como um número de 32 bits que varia entre -2.147.483.648 e 2.147.483.647.) que contém o índice menor disponível para a dimensão indicada de uma matriz (matriz: variável que contém um número finito de elementos com um nome e um tipo de dados comuns. Cada elemento de uma matriz é identificado por um número de índice exclusivo. As alterações efectuadas num elemento de uma matriz não afectam os outros elementos.).
Sintaxe
LBound(nomedamatriz [,
dimensão ] )
A sintaxe da função LBound tem os seguintes argumentos:
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 localizar o limite superior da dimensão de uma matriz.
Na tabela seguinte, LBound devolve os valores de uma matriz com as seguintes dimensões:
Dim A(1 To 100, 0 To 3, -3 To 4)
| Instrução |
Valor Devolvido |
LBound(A, 1) |
1 |
LBound(A, 2) |
0 |
LBound(A, 3) |
-3 |
O vínculo inferior predefinido de qualquer dimensão é 0 ou 1, dependendo da definição da instrução Base de Opção. A base de uma matriz criada com a função Matriz é zero; não é afectada pela Base de Opção.
As matrizes para as quais são definidas dimensões, que utilizam a cláusula To numa instrução Dim, Privada, Pública, ReDim ou Estática podem ter qualquer valor inteiro como vínculo inferior.
Exemplo
Nota Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.
Este exemplo utiliza a função LBound para determinar o índice menor disponível da dimensão indicada de uma matriz. Utilize a instrução Base de Opção para substituir o valor do índice da 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.