Функция LBound (Visual Basic)
Обновлен: Ноябрь 2007
Возвращает наименьший доступный индекс для указанного измерения массива.
Public Function LBound( _
ByVal Array As System.Array, _
Optional ByVal Rank As Integer = 1 _
) As Integer
Параметры
Array
Обязательно. Массив любого типа данных. Массив, в котором осуществляется поиск минимального индекса измерения.Rank
Необязательно. Integer. Измерение, для которого возвращается минимальный индекс. Используйте 1 для первого измерения, 2 — для второго и т.д. Если параметр Rank опущен, используется значение 1.
Возвращаемое значение
Integer. Может содержать минимальное значение нижнего индекса для указанного измерения. LBound всегда возвращает значение 0 для инициализированного массива Array, даже если массив не содержит элементов, например, если он является строкой нулевой длины. Если Array имеет значение Nothing, то LBound вызывает исключение ArgumentNullException.
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
Значение параметра Array составляет Nothing. |
||
Параметр Rank меньше 1 или Rank превышает ранг массива Array. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако по возможности следует заменять такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Поскольку значения индексов массива начинаются с 0, минимальный доступный индекс для любой размерности всегда равен 0.
Для массива со следующими измерениями функция LBound возвращает значения, перечисленные в следующей таблице:
Dim a(100, 5, 4) As Byte
Вызов LBound |
Возвращаемое значение |
|---|---|
LBound(a, 1) |
0 |
LBound(a, 2) |
0 |
LBound(a, 3) |
0 |
Пример
Пример демонстрирует применение функции LBound для определения минимального доступного значения индекса для указанного измерения массива.
Dim lowest, bigArray(10, 15, 20), littleArray(6) As Integer
lowest = LBound(bigArray, 1)
lowest = LBound(bigArray, 3)
lowest = LBound(littleArray)
' All three calls to LBound return 0.
Требования
Пространство имен: Microsoft.VisualBasic
Модуль: Information
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)