Information.LBound(Array, Int32) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve o subscrito mais baixo disponível para a dimensão indicada de um array.

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. Array de qualquer tipo de dado. O array em que se quer encontrar o subscrito mais baixo possível de uma dimensão.

Rank
Int32

Optional. Integer. A dimensão para a qual se deve devolver o subscrito mais baixo possível. Utilize 1 para a primeira dimensão, 2 para a segunda e assim sucessivamente. Se Rank for omitido, assume-se 1.

Devoluções

Int32

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

Exceções

ArgumentNullException

Array é Nothing.

RankException

Rank menor que 1, ou Rank é maior que o posto de Array.

Exemplos

O exemplo seguinte utiliza a LBound função para determinar o subscrito mais baixo disponível para a dimensão indicada de um array.

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.

Observações

Como os subscritos do array começam em 0, o subscrito mais baixo disponível para cada dimensão é sempre 0.

Para um array com as seguintes dimensões, LBound devolve os valores na tabela seguinte:

Dim a(100, 5, 4) As Byte
Chamada ao LBound Valor de retorno
LBound(a, 1) 0
LBound(a, 2) 0
LBound(a, 3) 0

Aplica-se a

Ver também