Information.LBound(Array, Int32) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Information.vb

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

public static int LBound (Array Array, int Rank = 1);

static member LBound : Array * int -> int

Public Function LBound (Array As Array, Optional Rank As Integer = 1) As Integer

Parâmetros

Array

Array

Obrigatórios. Matriz de qualquer tipo de dados. A matriz na qual você deseja encontrar o subscrito mais baixo possível de uma dimensão.

Rank

Int32

Opcional. Integer. A dimensão para a qual o subscrito mais baixo possível deve ser retornado. Use 1 para a primeira dimensão, 2 para a segunda e assim por diante. Se Rank for omitido, 1 será pressuposto.

Retornos

Int32

Integer. O valor mais baixo da subscrição que a dimensão especificada pode conter. LBound sempre retorna 0, desde que Array tenha sido inicializado, mesmo se não contiver elementos, como por exemplo, se for uma cadeia de comprimento zero. Se Array for Nothing, LBound gera um ArgumentNullException.

Exceções

ArgumentNullException

Array é Nothing.

RankException

Rank é menor que 1 ou Rank é maior que a classificação de Array.

Exemplos

O exemplo a seguir usa a LBound função para determinar o subscrito mais baixo 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.

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  

Chamar para LBound	Valor retornado
LBound(a, 1)	0
LBound(a, 2)	0
LBound(a, 3)	0

Confira também

• UBound(Array, Int32)
• ArgumentException
• RankException
• Instrução Dim (Visual Basic)
• Instrução ReDim (Visual Basic)