Contains
TypedElementListLibraryЧто это
Pure-функция, проверяющая, содержит ли типизированный список (Typed Element List) элемент с заданным дескриптором (Typed Element Handle). Возвращает true, если элемент найден, иначе false.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Typed Element List) — список, в котором выполняется поиск
- Element (Typed Element Handle) — дескриптор искомого элемента
Выходы (данные):
- Return Value (Boolean) — результат проверки
Когда используется
При работе с коллекциями типизированных элементов, когда нужно избежать дублирования или убедиться, что элемент уже добавлен в список перед выполнением операций (удаление, изменение). Также применяется в логике выборки или фильтрации элементов.
Типичные проблемы
- Невалидный дескриптор (handle): если элемент был уничтожен или дескриптор получен из другого списка,
Containsвернётfalse, но это не вызовет ошибки. - Сравнение с дескриптором из другого списка: каждый
Typed Element Listуправляет своими дескрипторами; элемент из одного спика не распознаётся в другом. - Пустой список: вызов на пустом списке безопасен, результат всегда
false— это может ввести в заблуждение при отладке, если список не был наполнен.