Condividi tramite


Funzione LBound (Visual Basic)

Aggiornamento: novembre 2007

Restituisce l'indice minimo disponibile per la dimensione specificata di una matrice.

Public Function LBound( _
   ByVal Array As System.Array, _
   Optional ByVal Rank As Integer = 1 _
) As Integer

Parametri

  • Array
    Obbligatorio. Matrice con dati di qualsiasi tipo, nella quale cercare l'indice minimo disponibile di una dimensione.

  • Rank
    Facoltativo. Integer. Dimensione per la quale restituire l'indice minimo disponibile. È necessario specificare 1 per la prima dimensione, 2 per la seconda e così via. Se Rank viene omesso, verrà utilizzato 1.

Valore restituito

Integer. Valore minimo che l'indice relativo alla dimensione specificata può contenere. LBound restituisce sempre 0 a condizione che Array sia stato inizializzato, anche se non contiene elementi, ad esempio se si tratta di una stringa di lunghezza zero. Se Array è Nothing, LBound genera un'eccezione ArgumentNullException.

Eccezioni

Tipo di eccezione

Numero di errore

Condizione

ArgumentNullException

9

Array è Nothing.

RankException

9

Rank < 1 oppure è maggiore del numero di dimensioni di Array.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Dato che gli indici di matrice partono da 0, l'indice minimo di qualsiasi dimensione è sempre 0.

Per una matrice con le seguenti dimensioni LBound restituirà i valori indicati nella tabella riportata di seguito:

Dim a(100, 5, 4) As Byte

Chiamata di LBound

Valore restituito

LBound(a, 1)

0

LBound(a, 2)

0

LBound(a, 3)

0

Esempio

Nell'esempio riportato di seguito la funzione LBound viene utilizzata per determinare l'indice minimo disponibile per la dimensione indicata di una matrice.

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.

Requisiti

Spazio dei nomi: Microsoft.VisualBasic

Modulo: Information

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

Vedere anche

Riferimenti

Funzione UBound (Visual Basic)

Istruzione Dim (Visual Basic)

Istruzione ReDim (Visual Basic)

ArgumentException

RankException