Information.UBound(Array, Int32) Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.VisualBasic
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.Core.dll
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.dll
Kaynak:
Information.vb
Kaynak:
Information.vb
Kaynak:
Information.vb

Bir dizinin belirtilen boyutu için en yüksek kullanılabilir alt simgeyi döndürür.

public static int UBound (Array Array, int Rank = 1);
static member UBound : Array * int -> int
Public Function UBound (Array As Array, Optional Rank As Integer = 1) As Integer

Parametreler

Array
Array

Gereklidir. Herhangi bir veri türünün dizisi. Bir boyutun mümkün olan en yüksek alt indisini bulmak istediğiniz dizi.

Rank
Int32

İsteğe bağlı. Integer. Mümkün olan en yüksek alt indis döndürülecek boyut. İlk boyut için 1, ikinci boyut için 2 vb. kullanın. Atlanırsa Rank , 1 varsayılır.

Döndürülenler

Int32

Integer. Belirtilen boyut için alt simgenin içerebileceği en yüksek değer. Yalnızca bir öğe varsa Array , UBound 0 döndürür. Array Öğe yoksa ( örneğin sıfır uzunlukta bir dizeyse) UBound -1 döndürür.

Özel durumlar

ArgumentNullException

Array, Nothing değeridir.

RankException

Rank 1'den küçük veya Rank değerinden Arraybüyük.

Örnekler

Aşağıdaki örnek, bir dizinin belirtilen boyutu için en yüksek kullanılabilir alt simgeyi belirlemek için işlevini kullanır UBound .

Dim highest, bigArray(10, 15, 20), littleArray(6) As Integer
highest = UBound(bigArray, 1)
highest = UBound(bigArray, 3)
highest = UBound(littleArray)
' The three calls to UBound return 10, 20, and 6 respectively.

Açıklamalar

Dizi alt indisleri 0'dan başladığından, boyutun uzunluğu bu boyut için kullanılabilir en yüksek alt simgeden bir daha büyük olur.

Aşağıdaki boyutlara sahip bir dizi için aşağıdaki UBound tabloda yer alan değerleri döndürür:

Dim a(100, 5, 4) As Byte
UBound çağrısı Döndürülen değer
UBound(a, 1) 100
UBound(a, 2) 5
UBound(a, 3) 4

Bir dizideki öğelerin toplam sayısını belirlemek için kullanabilirsiniz UBound , ancak alt indislerin 0'da başlaması nedeniyle döndürdüğü değeri ayarlamanız gerekir. Aşağıdaki örnek, önceki örnekte dizinin a toplam boyutunu hesaplar:

Dim total As Integer  
total = (UBound(A, 1) + 1) * (UBound(A, 2) + 1) * (UBound(A, 3) + 1)

için total hesaplanan değer 3030'dur ve 101 * 6 * 5'tir.

Şunlara uygulanır

Ayrıca bkz.