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
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.