Заменить NULL в SQL SqlHelper::getIsNullFunction
Модуль: main — подключать отдельно не нужно
Метод SqlHelper::getIsNullFunction возвращает SQL-выражение, которое возвращает result, если expression равно NULL, и expression в остальных случаях. Аналог в классическом API — CDatabase::IsNull, он вызывает этот метод.
Сигнатура метода в классе Bitrix\Main\DB\SqlHelper:
abstract public function getIsNullFunction($expression, $result);
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| expression* | string |
Задает колонку или SQL-выражение для проверки. Метод подставляет значение в SQL без экранирования |
| result* | string |
Задает колонку или SQL-выражение для замены NULL. Метод подставляет значение в SQL без экранирования |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает строку string — SQL-выражение.
| Реализация | Выражение |
|---|---|
MysqliSqlHelper |
IFNULL(<expression>, <result>) |
PgsqlSqlHelper |
COALESCE(<expression>, <result>) |
Примеры
Пример. Код выводит дату последнего входа, а для пользователей без входа — дату регистрации:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\UserTable;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$connection = Application::getConnection();
$helper = $connection->getSqlHelper();
$result = $connection->query(
'SELECT LOGIN, ' . $helper->getIsNullFunction('LAST_LOGIN', 'DATE_REGISTER') . ' AS SEEN'
. ' FROM ' . $helper->quote(UserTable::getTableName()) . ' ORDER BY ID',
3
);
while ($row = $result->fetch())
{
echo $row['LOGIN'] . ' ' . $row['SEEN'] . PHP_EOL;
}
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая