Difference between revisions of "Coalesce"
m (1 revision imported) |
1>Admin |
||
| Line 3: | Line 3: | ||
|object=[[Функции общего назначения]] | |object=[[Функции общего назначения]] | ||
|caption=Проверка аргументов | |caption=Проверка аргументов | ||
| − | |type= | + | |type=2 |
|status=2 | |status=2 | ||
|db=0 | |db=0 | ||
| Line 12: | Line 12: | ||
* [[Объекты]] | * [[Объекты]] | ||
* [[Функции общего назначения]]}} | * [[Функции общего назначения]]}} | ||
| − | Функция возвращает первый из аргументов, который не является пустым (не выбранным) объектом базы данных, пустым значением, либо не является объектом базы данных. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''. В отличие от [[IsEmpty]], функция не считает пустыми значениями число ''0'', пустую строку ''""'' и пустую дату. См. также функцию [[CoalesceEx]]. | + | Функция возвращает первый из аргументов, который не является пустым (не выбранным) объектом базы данных, пустым значением, либо не является объектом базы данных. Функция может использоваться вместо более сложной для понимания конструкции с оператором ''If''. В отличие от [[IsEmpty]], функция не считает пустыми значениями число ''0'', пустую строку ''""'' и пустую дату. Функция является магической (вычисление следующего аргумента не выполняется, если текущий удовлетворяет условию функции). См. также функцию [[CoalesceEx]]. |
== Синтаксис == | == Синтаксис == | ||
Revision as of 13:06, 27 December 2025
| 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);
