Coalesce - 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:27Z

Admin: 1 revision imported

2023-11-27T06:41:31Z

1 revision imported

1>Admin at 08:18, 28 October 2023

2023-10-28T08:18:38Z

Admin: 1 revision imported

2021-02-07T06:43:14Z

1 revision imported

Admin at 06:24, 13 September 2019

2019-09-13T06:24:09Z

New page

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

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

== Примеры ==
<pre>
//Будет выведено 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);
</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: @@
 * [[Объекты]]
 * [[Функции общего назначения]]}}
-Функция возвращает первый из аргументов, который не является пустым (не выбранным) объектом базы данных, пустым значением, либо не является объектом базы данных. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''. В отличие от [[IsEmpty]], функция не считает пустыми значениями число ''0'', пустую строку ''""'' и пустую дату. См. также функцию [[CoalesceEx]].
+Функция возвращает первый из аргументов, который не является пустым (не выбранным) объектом базы данных, пустым значением, либо не является объектом базы данных. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''. В отличие от [[IsEmpty]], функция не считает пустыми значениями число ''0'', пустую строку ''""'' и пустую дату. Функция является магической (вычисление следующего аргумента не выполняется, если текущий удовлетворяет условию функции). См. также функцию [[CoalesceEx]].
 == Синтаксис ==

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

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)