Microsoft Office Online
Iniciar sessão no Meu Office Online (O que é isto?) | Iniciar sessão

 
 
Microsoft Office Access
Procurar
Procurar
 
 
 
 
Aviso: está a visualizar esta página com um browser não suportado. Este Web site funciona melhor com o Microsoft Internet Explorer 6.0 ou posterior, o Firefox 1.5 ou o Netscape Navigator 8.0 ou posterior. Mais informações sobre browsers suportados.

Função LBound
 

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:

Argumento Descrição
nomedamatriz Obrigatório. nome da variável (variável: um local de armazenamento com nome que pode conter dados que é possível modificar durante a execução do programa. Cada variável possui um nome que a identifica exclusivamente no respectivo nível de âmbito. Um tipo de dados pode ser ou não especificado.) da matriz; segue as convenções de nomenclatura de variáveis padrão.
dimensão Opcional. Variante (Longo). Número inteiro que indica qual o vínculo 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 o valor 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 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.

		
Consulte também
anúncio