Information.LBound(Array, Int32) Método

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

Required. 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

Optional. Integer. A dimensão para a qual o subscrito mais baixo possível deve ser retornado. Utilize 1 para a primeira dimensão, 2 para a segunda e assim sucessivamente. Se Rank for omitido, 1 será assumido.

Retornos

Int32

Integer. O valor mais baixo que o subscrito para a dimensão especificada pode conter. LBound sempre retorna 0 desde Array que tenha sido inicializado, mesmo que não tenha elementos, por exemplo, se for uma cadeia de caracteres de comprimento zero. Se Array for Nothing, LBound lançará 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 os subscritos de matriz começam em 0, o subscrito mais baixo 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 de devolução
LBound(a, 1) 0
LBound(a, 2) 0
LBound(a, 3) 0

Aplica-se a

Confira também