Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы объекта Список Значений

Принадлежит

Проверяет вхождение в список значений указанного значения.

Синтаксис:

Принадлежит(<Значение>)

Англоязычный синоним:

Belong

Параметры:

<Значение> Значение, проверяемое на вхождение в список значений.

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

Число: 1 – если проверяемое значение входит в список значений; 0 – если не входит.

Описание:

Метод Принадлежит проверяет вхождение в список значений заданного значения. Другими словами, оператор Список.Принадлежит(ВыбДок) проверяет, является ли значение ВыбДок подмножеством списка значений Список.

Если на принадлежность проверяется значение типа элемент справочника, то проверка выполняется с учетом его возможного вхождения в группы справочников, которые являются значениями списка значений.

Данный метод оптимизирует проверку принадлежности при массовых последовательных сравнениях, если между сравнениями сам список значений не меняется.

Пример:

Процедура ПроверитьКлиентов(СписокГруппКлиентов)

// в качестве параметра Процедуры передается СписокЗначений

// в котором записаны как элементы справочника Клиенты, так и

// группы этого справочника

Док = СоздатьОбъект("Документ.Накладная");

Док.ВыбратьДокументы();

Пока Док.ПолучитьДокумент() = 1 Цикл

Если СписокГруппКлиентов.Принадлежит(Док.Клиент) = 1 Тогда

Сообщить(Док.Клиент.Наименование + " " + Док);

КонецЕсли;

КонецЦикла;

КонецПроцедуры
Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.