Заменить 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;
}

Смотрите также