Получить общее число строк Result::getCount

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

Метод Result::getCount возвращает общее число строк по фильтру без учета limit и offset. Число нужно для постраничной навигации. Метод вызывает DB\Result::getCount.

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

public function getCount()

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

Метод возвращает целое число.

Исключения

Исключение Когда возникает
Bitrix\Main\ObjectPropertyException Запрос не содержит count_total, и метод setCount не задал число

Особенности

Параметр count_total может выполнить дополнительный запрос COUNT, если выборка ограничена limit и вернула полную страницу. Включайте параметр, только когда число нужно.

Примеры

Пример. Код получает страницу и общее число строк для навигации:

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

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

$nav = new PageNavigation('nav-languages');
$nav->setPageSize(1);

$result = LanguageTable::getList([
    'select' => ['LID'],
    'filter' => ['@LID' => ['en', 'ru']],
    'offset' => $nav->getOffset(),
    'limit' => $nav->getLimit(),
    'count_total' => true,
]);
$nav->setRecordCount($result->getCount());

echo $nav->getPageCount();

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

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