Получает наибольший индекс элемента массива.
Синтаксис
ВГраница()Примеры платформы
Для Индекс = 0 по Массив.ВГраница() Цикл
Массив[Индекс] = Массив[Индекс] + 1;
КонецЦикла;Полное описание, параметры и ограничения
Массив.ВГраница (Array.UBound)
Массив (Array)
ВГраница (UBound)
Доступен, начиная с версии 8.0.
Синтаксис:
ВГраница()
Возвращаемое значение:
Тип: Число.
Наибольший индекс в массиве. Если количество элементов массива равно 0, возвращает -1.
Описание:
Получает наибольший индекс элемента массива.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Наибольший индекс соответствует количеству элементов массива минус 1.
Пример:
Для Индекс = 0 по Массив.ВГраница() Цикл
Массив[Индекс] = Массив[Индекс] + 1;
КонецЦикла;
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Изменить порядок товаров в массиве без поиска по названию
Показывает разницу между добавлением в конец, вставкой по индексу и заменой существующего значения. Исходные данные создаются прямо в коде.
Где и как запускать
Фрагмент внутри процедуры в клиентском или серверном контексте, поддерживающем Массив.
Подготовка
Создайте учебную команду или процедуру. Поместите фрагмент внутрь её тела.
Внешние файлы и объекты конфигурации не нужны: массив создаётся в памяти.
Товары = Новый Массив;
Товары.Добавить("Книга");
Товары.Добавить("Ручка");
Товары.Вставить(1, "Тетрадь");
Товары.Установить(2, "Карандаш");
Сообщить(Товары.Получить(1));
Сообщить(Товары.Количество());
Сообщить(Товары.ВГраница());
Для Каждого Товар Из Товары Цикл
Сообщить(Товар);
КонецЦикла;Разбор по шагам
Добавить помещает два значения в конец массива: они занимают индексы 0 и 1.
Вставить с индексом 1 помещает Тетрадь перед Ручка; прежняя ручка перемещается на индекс 2.
Установить заменяет значение по индексу 2, не увеличивая количество элементов.
Получить(1) возвращает Тетрадь. Количество равно 3, а ВГраница — 2, поскольку индексы начинаются с нуля.
Цикл выводит конечный порядок элементов.
Как проверить результат
Первыми сообщениями должны быть Тетрадь, 3 и 2, затем Книга, Тетрадь, Карандаш.
Замените индекс Установить на 1: количество останется 3, но изменится второй элемент.
В отладчике проверьте индексы сразу после Вставить: ранее существовавшие элементы сдвинулись.
Ожидаемый результат
Конечный массив: Книга, Тетрадь, Карандаш. Вставка меняет длину, замена — нет.
На что обратить внимание
Нельзя читать или заменять элемент с индексом, выходящим за границы массива.
Не путайте порядковый номер для пользователя (первый, второй) с индексом (0, 1).
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.