Information.UBound(Array, Int32) Метод

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic
Сборка:
Microsoft.VisualBasic.Core.dll
Сборка:
Microsoft.VisualBasic.dll
Исходный код:
Information.vb
Исходный код:
Information.vb
Исходный код:
Information.vb

Возвращает наибольший доступный индекс для указанной размерности массива.

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

Параметры

Array
Array

Обязательный. Массив данных любого типа. Массив, в котором осуществляется поиск наибольшего индекса измерения.

Rank
Int32

Необязательный элемент. Integer. Измерение, для которого возвращается максимальный индекс. Используйте 1 для первого измерения, 2 — для второго и т. д. Если параметр Rank опущен, используется значение 1.

Возвращаемое значение

Int32

Integer. Может содержать самое большое значение нижнего индекса для указанного измерения. Если массив Array содержит ровно один элемент, метод UBound возвращает значение 0. Если массив Array не содержит элементов (например, является строкой нулевой длины), метод UBound возвращает значение -1.

Исключения

ArgumentNullException

Array имеет значение Nothing.

RankException

Параметр Rank меньше 1 или Rank превышает ранг Array.

Примеры

В следующем примере функция используется для 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.

Комментарии

Так как индексы массива начинаются с 0, длина измерения на один больше, чем самый высокий доступный индекс для этого измерения.

Для массива со следующими измерениями UBound возвращает значения из следующей таблицы:

Dim a(100, 5, 4) As Byte
Вызов UBound Возвращаемое значение
UBound(a, 1) 100
UBound(a, 2) 5
UBound(a, 3) 4

Можно использовать для UBound определения общего количества элементов в массиве, но необходимо настроить возвращаемое значение с учетом того факта, что индексы начинаются с 0. В следующем примере вычисляется общий размер массива a в предыдущем примере:

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

Значение, вычисленное для total , равно 3030, то есть 101 * 6 * 5.

Применяется к

См. также раздел