Information.UBound(Array, Int32) Metoda

  • Reference

Definice

Obor názvů:
Microsoft.VisualBasic
Sestavení:
Microsoft.VisualBasic.Core.dll
Sestavení:
Microsoft.VisualBasic.dll
Zdroj:
Information.vb
Zdroj:
Information.vb
Zdroj:
Information.vb

Vrátí nejvyšší dostupný dolní index pro zadanou dimenzi pole.

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

Parametry

Array
Array

Povinná hodnota. Pole libovolného datového typu. Pole, ve kterém chcete najít nejvyšší možný dolní index dimenze.

Rank
Int32

Nepovinný parametr. Integer. Dimenze, pro kterou má být vrácen nejvyšší možný dolní index. Použijte 1 pro první dimenzi, 2 pro druhou atd. Pokud Rank se vynechá, předpokládá se hodnota 1.

Návraty

Int32

Integer. Nejvyšší hodnota, kterou může dolní index pro zadanou dimenzi obsahovat. Pokud Array obsahuje pouze jeden prvek, UBound vrátí hodnotu 0. Pokud Array neobsahuje žádné prvky, například pokud se jedná o řetězec nulové délky, UBound vrátí se hodnota -1.

Výjimky

ArgumentNullException

Array je Nothing.

RankException

Rank je menší než 1 nebo Rank je větší než pořadí Array.

Příklady

Následující příklad používá UBound funkci k určení nejvyššího dostupného dolního indexu pro určenou dimenzi pole.

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.

Poznámky

Vzhledem k tomu, že dolní indexy pole začínají na 0, je délka dimenze větší o jeden než nejvyšší dostupný dolní index pro danou dimenzi.

Pro pole s následujícími dimenzemi UBound vrátí hodnoty v následující tabulce:

Dim a(100, 5, 4) As Byte
Volání do UBound Vrácená hodnota
UBound(a, 1) 100
UBound(a, 2) 5
UBound(a, 3) 4

Můžete použít UBound k určení celkového počtu prvků v poli, ale musíte upravit hodnotu, kterou vrací, aby zohlednila skutečnost, že dolní indexy začínají na 0. Následující příklad vypočítá celkovou velikost pole a v předchozím příkladu:

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

Hodnota vypočítaná pro total je 3030, což je 101 × 6 × 5.

Platí pro

Viz také