Документация для разработчиков

GetNext

mixed
CIBlockResult::GetNext(
bool bTextHtmlAuto = true,
bool use_tilda = true
);

Возвращает массив значений полей приведенный в HTML безопасный вид. Также в полях DETAIL_PAGE_URL и LIST_PAGE_URL заменяются шаблоны вида #IBLOCK_ID# и т.п. на их реальные значения, в результате чего в этих полях будут ссылки на страницу детального просмотра и страницу списка элементов.

Если выборка была из инфоблока свойства которого хранятся отдельно (Режим хранения свойств в отдельных таблицах), то для правильной обработки значений множественных свойств требуется наличие полей ID и IBLOCK_ID. Нестатический метод.

Список шаблонов

  • #SITE_DIR# - заменяется на константу SITE_DIR;
  • #SERVER_NAME# - заменяется на константу SITE_SERVER_NAME;
  • #ID# - заменяется на идентификатор элемента или раздела;
  • #CODE# - заменяется на символьный код элемента или раздела;
  • #EXTERNAL_ID# - заменяется на внешний код элемента или раздела;
  • #IBLOCK_TYPE_ID# - заменяется на идентификатор типа инфоблока которому принадлежит элемент или раздел;
  • #IBLOCK_ID# - заменяется на идентификатор инфоблока которому принадлежит элемент или раздел;
  • #IBLOCK_CODE# - заменяется на символьный код инфоблока которому принадлежит элемент или раздел;
  • #IBLOCK_EXTERNAL_ID# - заменяется на внешний код инфоблока которому принадлежит элемент или раздел;
  • #ELEMENT_ID# - заменяется на идентификатор элемента;
  • #ELEMENT_CODE# - заменяется на символьный код элемента;
  • #SECTION_CODE# - заменяется на символьный код раздела (использование этого шаблона может привести к дополнительным запросам к базе данных).

Параметры вызова

ПараметрОписаниеС версии
$bTextHtmlAuto Параметр передается в CDBResult::GetNext. Необязательный, по умолчанию принимает true.6.0.0
use_tilda

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

Метод возвращает массив с полями элемента информационного блока вида Array("поле"=>"преобразованное значение", "~поле"=>"не преобразованное значение", [, ...]) и передвигает курсор на следующую запись.
Если достигнута последняя запись (или в результате нет ни одной записи) метод вернет false.

См. также

Примеры использования

<?
$res = CIBlockElement::GetByID($_GET["PID"]);
if($ar_res = $res->GetNext())
echo '<a href="'.$ar_res['DETAIL_PAGE_URL'].'">'.$ar_res['NAME'].'</a>';
else
echo 'Элемент не найден.';
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх