Information.UBound(Array, Int32) Metoda
Definice
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 uvedenou dimenzi pole.
public static int UBound(Array Array, int Rank = 1);static member UBound : Array * int -> intPublic Function UBound (Array As Array, Optional Rank As Integer = 1) As IntegerParametry
- Array
- Array
Required. Pole libovolného datového typu Pole, ve kterém chcete najít nejvyšší možný dolní index dimenze.
- Rank
- Int32
Optional.
Integer. Dimenze, pro kterou se má vrátit nejvyšší možný dolní index. Použijte 1 pro první dimenzi, 2 pro druhou atd. Pokud Rank tento parametr vynecháte, předpokládá se hodnota 1.
Návraty
Integer. Nejvyšší hodnota dolního indexu pro zadanou dimenzi může obsahovat. Pokud Array má 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í hodnotu -1.
Výjimky
Array je Nothing.
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 uvedenou 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í na UBound | Návratová 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 matici, ale musíte upravit hodnotu, která se vrátí, 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 3030, což je 101 * 6 * 5.
