Função LBound (Visual Basic)

Artigo
08/25/2010

Retorna o menor subscrito disponível para a dimensão indicada de uma matriz.

Public Function LBound( _
   ByVal Array As System.Array, _
   Optional ByVal Rank As Integer = 1 _
) As Integer

Parâmetros

Array
Obrigatório.Matriz de qualquer tipo de dados.A matriz em que você deseja encontrar o menor subscrito possível de uma dimensão.
Rank
Opcional.Integer.A dimensão para o qual o menor possível subscrito será retornado.Use 1 para a primeira dimensão, 2 para a segunda e assim por diante.Se Rank for omitido, 1 será adotado.

Valor de retorno

Integer.O valor mais baixo o subscrito para a dimensão especificada pode conter.LBound sempre retorna 0, desde que Array foi inicializado, mesmo não tendo nenhum elemento, por exemplo, se for uma cadeia de comprimento zero. Se Array é Nothing, LBound lança uma ArgumentNullException.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentNullException	9	Array é Nothing.
RankException	9	Rank < 1 ou Rank é maior do que a classificação de Array.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Como subscritos de matriz iniciam em 0, a menor subscrição disponível para cada dimensão é sempre 0.

Para uma matriz com as seguintes dimensões, LBound retorna os valores na tabela a seguir:

Dim a(100, 5, 4) As Byte

Chamada para LBound	Valor de Retorno
LBound(a, 1)	0
LBound(a, 2)	0
LBound(a, 3)	0

Exemplo

O exemplo a seguir usa a função LBound para determinar a menor subscrição disponível para a dimensão indicada de uma matriz.

Dim lowest, bigArray(10, 15, 20), littleArray(6) As Integer
lowest = LBound(bigArray, 1)
lowest = LBound(bigArray, 3)
lowest = LBound(littleArray)
' All three calls to LBound return 0.