List.Contains

Contains (Вхождение объекта в список)
Объект: Список Статус разработки: Реализована Тип: Функция Обращение к БД: Сервер и БД Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Список

Функция проверяет, является ли указанный элемент подмножеством списка. Проверяются только элементы-объекты базы данных. Если требуется проверить объект иного типа, нужно использовать функцию Find. Список может содержать папки и отдельные значения. При наличии папок в списке, элемент проверяется на вхождение внутрь каждой из папок. Подобный процесс может занять некотрое время, в зависимости от загруженности и готовности базы данных, поэтому, после первого обращения, функция сохраняет промежуточные результаты запроса, последующие обращения происходят без запросов к базе данных, тем самым ускоряя выполнение, однако, возможные изменения в данных при этом не учитываются. Чтобы форсировать запрос к базе данных, используйте функцию ClearContainsCache перед вызовом.

Синтаксис

List.Contains(<Значение>):<0 или 1 (INT)>

Аргументы

• <Значение> - Элемент-объект базы данных для проверки.

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

Возвращает 1, если объект входит в список, 0 если не входит или не является объектом базы данных.

Примеры

//Пример нельзя проверить в рабочей базе данных, как указаны конкретные коды объектов, он используется только для демонстрации
//Список содержит два объекта базы данных, один из которых является папкой.
a:=List.Create(DB("Ref.Номенклатура","Code","000000003661"),DB("Ref.Номенклатура","Code","000000007561"));
//Переменная содержит объект, родительской папкой которого является объект с кодом "000000003661"
b:=DB("Ref.Номенклатура","Code","000000003669");
//Выводит "Да"
Message(?(a.Contains(b),"Да","Нет"));