CoalesceEx - Revision history

Admin: 1 revision imported

2025-12-27T17:04:40Z

1 revision imported

1>Admin at 11:06, 27 December 2025

2025-12-27T11:06:39Z

Admin: 1 revision imported

2023-11-27T06:41:32Z

1 revision imported

1>Admin at 08:18, 28 October 2023

2023-10-28T08:18:27Z

New page

{{infobox function
|name=CoalesceEx
|object=[[Функции общего назначения]]
|caption=Проверка аргументов
|type=1
|status=2
|db=0
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция возвращает первый из аргументов, который не является пустым объектом по правилам, заданным режимом. В режиме ''0'' функция работает аналогично функции [[Coalesce]]. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''.

== Синтаксис ==
<code>
'''CoalesceEx'''({{Optional|<Режим>{{Default|{{Eq}}1}}}}{{Default|}}{{Optional|,<Аргумент 1>,<Аргумент 2>...}}):''<Первый не пустой объект по правилам, заданым режимом>''
</code>
==== Аргументы ====
* <code>''<Режим>''</code> - {{Optional}} Режим работы функции. Аргумент может принимать следующие значения:
** '''0''' -- Функция работает аналогично [[Coalesce]]. Пустые строка, дата или число ноль не считаются пустыми объектами. Функция может возвратить любой первый непустой объект, в том числе и не DB-объект.
** '''1''' (по умолчанию) -- Функция может возвратить только первый непустой DB-объект. Объекты, не являющиеся объектами базы данных, пропускаются при работе функции.
** '''2''' -- Пустые строка, дата или число ноль считаются пустыми объектами. Функция может возвратить любой первый непустой объект, в том числе и не DB-объект.
* <code>''<Аргумент ?>''</code> - {{Optional}} Объекты для проверки.
==== Возвращаемое значение ====
Возвращает один из аргументов, если все аргументы не подходят по условию отбора, задающемуся режимом, возвращает пустое значение.

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

← Older revision	Revision as of 17:04, 27 December 2025
(No difference)

@@ Line 3: / Line 3: @@
 |object=[[Функции общего назначения]]
 |caption=Проверка аргументов
-|type=1
+|type=2
 |status=2
 |db=0
@@ Line 12: / Line 12: @@
 * [[Объекты]]
 * [[Функции общего назначения]]}}
-Функция возвращает первый из аргументов, который не является пустым объектом по правилам, заданным режимом. В режиме ''0'' функция работает аналогично функции [[Coalesce]]. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''.
+Функция возвращает первый из аргументов, который не является пустым объектом по правилам, заданным режимом. В режиме ''0'' функция работает аналогично функции [[Coalesce]]. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''. Функция является магической (вычисление следующего аргумента не выполняется, если текущий удовлетворяет условию функции).
 == Синтаксис ==

← Older revision	Revision as of 06:41, 27 November 2023
(No difference)