Задать функции преобразования Result::setConverters

Модуль: main — подключать отдельно не нужно

Метод Result::setConverters заменяет функции преобразования значений колонок. Метод вызывает DB\Result::setConverters.

Сигнатура метода в классе Bitrix\Main\ORM\Query\Result:

public function setConverters($converters)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
converters* callable[] Задает функции в виде имя колонки => функция. Функция принимает значение и возвращает новое. Пустой массив отключает преобразования, в том числе дат

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод ничего не возвращает.

Особенности

Метод заменяет весь список. Чтобы добавить свою функцию к стандартным, получите список методом getConverters и дополните его. Чтобы изменить всю строку целиком, используйте addFetchDataModifier.

Примеры

Пример. Код приводит название языка к верхнему регистру:

<?php
use Bitrix\Main\Localization\LanguageTable;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$result = LanguageTable::getList(['select' => ['LID', 'NAME'], 'filter' => ['=LID' => 'en']]);

$converters = $result->getConverters();
$converters['NAME'] = static fn($value) => mb_strtoupper($value);
$result->setConverters($converters);

echo $result->fetch()['NAME'];

Код выведет ENGLISH.

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