CoalesceEx

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

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

Функция возвращает первый из аргументов, который не является пустым объектом по правилам, заданным режимом. В режиме 0 функция работает аналогично функции Coalesce. Функция может использоваться вместо более сложной для понимания конструкции с оператором If.

Синтаксис

CoalesceEx(<Режим>=1,<Аргумент 1>,<Аргумент 2>...):<Первый не пустой объект по правилам, заданым режимом>

Аргументы

• <Режим> - (необязательный аргумент) Режим работы функции. Аргумент может принимать следующие значения:
  • 0 -- Функция работает аналогично Coalesce. Пустые строка, дата или число ноль не считаются пустыми объектами. Функция может возвратить любой первый непустой объект, в том числе и не DB-объект.
  • 1 (по умолчанию) -- Функция может возвратить только первый непустой DB-объект. Объекты, не являющиеся объектами базы данных, пропускаются при работе функции.
  • 2 -- Пустые строка, дата или число ноль считаются пустыми объектами. Функция может возвратить любой первый непустой объект, в том числе и не DB-объект.
• <Аргумент ?> - (необязательный аргумент) Объекты для проверки.

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

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

Примеры

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