Compartilhar via


Função LBound (Visual Basic)

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.

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**Information

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Função UBound (Visual Basic)

Instrução Dim (Visual Basic)

ReDim demonstrativo (Visual Basic)

ArgumentException

RankException