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