Função LBound
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
- Palavras-chave (Visual Basic for Applications)
- Instruções (Visual Basic for Applications)
- Funções (Visual Basic for Applications)
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.