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

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Sdílet prostřednictvím