Выдает целевой элемент массива по значению первичного ключа. См. также GetOptForeignElem.
Действие функции несколько отличается от функции ArrayOptFindByKey за счет поддержки рекурсивных массивов XML-элементов.
Кроме того, в новой объектной модели функция никогда не завершается с ошибкой, если соответствующий элемент не найден, а возвращает пустой псевдо-элемент (режим терпимости к незаполненным и битым ссылкам).
Синтаксис
GetForeignElem( array, keyVal )
Аргументы
- array (
XmlElem): Массив объектов. - keyVal (
any): Значение ключевого элемента.
Результат
- XmlElem: Целевой элемент массива (как правило).
Пример
GetForeignElem( event_types, 'interview' )