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

GetNext

Описание и параметры

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

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

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

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

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

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

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

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

  • #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# - заменяется на символьный код раздела (использование этого шаблона может привести к дополнительным запросам к базе данных).

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

<?
$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-2024, «1С-Битрикс», 2024