LBound-Funktion (Visual Basic)
Aktualisiert: November 2007
Gibt den niedrigsten verfügbaren Feldindex für die angegebene Dimension eines Arrays zurück.
Public Function LBound( _
ByVal Array As System.Array, _
Optional ByVal Rank As Integer = 1 _
) As Integer
Parameter
Array
Erforderlich. Array eines beliebigen Datentyps. Das Array, in dem der niedrigste mögliche Feldindex einer Dimension ermittelt werden soll.Rank
Optional. Integer. Die Dimension, für die der niedrigste mögliche Feldindexwert zurückgegeben wird. Verwenden Sie für die erste Dimension 1, für die zweite 2 usw. Wird Rank ausgelassen, so wird bei 1 begonnen.
Rückgabewert
Integer. Der niedrigste Wert, den der Feldindex für die angegebene Dimension enthalten kann. LBound gibt stets 0 (null) zurück, sofern Array initialisiert wurde, auch wenn das Array keine Elemente enthält, beispielsweise wenn es eine Zeichenfolge mit der Länge 0 (null) ist. Wenn Array den Wert Nothing hat, löst LBound eine ArgumentNullException-Ausnahme aus.
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
|---|---|---|
Array ist Nothing. |
||
Rank < 1 oder Rank ist größer als der Rang von Array. |
Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.
Hinweise
Da Arrayfeldindizes bei 0 beginnen, ist der niedrigste mögliche Feldindex für eine Dimension immer 0.
Bei einem Array mit den folgenden Dimensionen gibt LBound die Werte aus der folgenden Tabelle zurück:
Dim a(100, 5, 4) As Byte
Aufruf von LBound |
Rückgabewert |
|---|---|
LBound(a, 1) |
0 |
LBound(a, 2) |
0 |
LBound(a, 3) |
0 |
Beispiel
In diesem Beispiel wird mit der LBound-Funktion der niedrigste mögliche Arrayfeldindex für die angegebene Arraydimension bestimmt.
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.
Anforderungen
Namespace:Microsoft.VisualBasic
**Modul:**Information
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Siehe auch
Referenz
UBound-Funktion (Visual Basic)