Получить строку без преобразований Result::fetchRaw
Модуль: main — подключать отдельно не нужно
Доступно с версии: 15.5.1
Метод Result::fetchRaw возвращает следующую строку результата без преобразований, которые выполняет fetch. Метод оставляет даты строками, не десериализует значения и не переименовывает колонки.
Сигнатура метода в классе Bitrix\Main\DB\Result:
public function fetchRaw()
Возвращаемое значение
Метод возвращает массив имя колонки => значение или false, если строк больше нет.
Строку готовит реализация результата.
| Реализация | Строка |
|---|---|
MysqliResult |
Строка mysqli без изменений |
PgsqlResult |
Ключи в верхнем регистре. Значения колонок типа bytea раскодированы функцией pg_unescape_bytea |
Если код включил отслеживание через Connection::startTracker, метод добавляет время выборки и размер строки в сведения о запросе.
Примеры
Пример. Код сравнивает дату регистрации из fetchRaw и fetch. В первом случае это строка, во втором — объект:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\UserTable;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$connection = Application::getConnection();
$sql = 'SELECT DATE_REGISTER FROM ' . UserTable::getTableName() . ' ORDER BY ID';
$raw = $connection->query($sql, 1)->fetchRaw();
$converted = $connection->query($sql, 1)->fetch();
echo gettype($raw['DATE_REGISTER']) . ' / ' . get_class($converted['DATE_REGISTER']);
Код выведет string / Bitrix\Main\Type\DateTime.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая