Coalesce

Coalesce (Проверка аргументов)
Объект: Функции общего назначения Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Визуальность: Нет

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

Функция возвращает первый из аргументов, который не является пустым (не выбранным) объектом базы данных, пустым значением, либо не является объектом базы данных. Функция может использоваться вместо более сложной для понимания конструкции с оператором If. В отличие от IsEmpty, функция не считает пустыми значениями число 0, пустую строку "" и пустую дату. См. также функцию CoalesceEx.

Синтаксис

Coalesce(<Аргумент 1>,<Аргумент 2>...):<Первый не пустой или не БД объект>

Аргументы

• <Аргумент ?> - (необязательный аргумент) Объекты, первый выбранный или не БД объект из которых будет возвращен функцией.

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

Возвращает один из аргументов, если все аргументы являются не выбранными объектами БД или пустыми значениями, возвращает пустое значение.

Примеры

//Будет выведено 0, так как из всех аргументов, этот был первым не пустым объектом БД и не пустым значением
Message(Coalesce(DB,GetNothing,GetNothing("DOC.Реализация"),0,DB("Ref.Номенклатура","Code","000000000123")));

//aEl -- произвольный объект, если он пустой, функция должна возвратить 0 (ошибка). иначе сам объект.

//Конструкция без использования функции Coalesce:
If isEmpty(aEl) Then
  Exit 0;
Else
  Exit aEl;
EndIf;

//Конструкция с использованием функции Coalesce:
Exit Coalesce(aEl,0);