Partilhar via

Information.LBound(Array, Int32) Método

  • Referência

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Origem:
Information.vb
Origem:
Information.vb
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

Aplica-se a

Confira também