Главный модуль — функции — строки

 Bxstrrpos

Возвращает позицию последнего вхождения строки needle в haystack. Работает с UTF строками.

Параметры функции

Параметр Описание
haystack Стек
needle Строка

 

 CheckSerializedData

Проверка на валидность серилизованной строки. Всегда, при работе с неизвестным источником серилизованных данных необходимо делать проверку на валидность. Пример взлома.

Параметры функции

Параметр Описание
str Серилизованная строка
max_depth Максимальная вложенность данных обьекта или массива.

 

 htmlspecialcharsBack

Переводит текст из HTML-безопасного вида в исходное представление, заменяя в тексте:

Исходные символы После замены
&lt; <
&gt; >
&quot; «
&amp; &

 

 htmlspecialcharsEx

Переводит текст в HTML-безопасный вид, заменяя специальные символы их визуальным HTML представлением:

Исходные символы После замены
< &lt;
> &gt;
« &quot;
&quot; &amp;quot;
&amp; &amp;amp;
&lt; &amp;lt;
&gt; &amp;gt;

 

 HTMLToTxt

Преобразует исходный HTML-код в обычный текст путём удаления тегов или замены их на эквивалентное текстовое форматирование.

Параметры функции

Параметр Описание С версии
text Исходный текст в формате HTML.
host Web-адрес сайта. Если задан, то дописывается перед каждой ссылкой в HTML для формирования абсолютной ссылки.
Необязательный параметр. По умолчанию равен — «».
delete Массив шаблонов регулярных выражений, которые удаляются из текста.
Необязательный параметр. По умолчанию — пустой массив.
До версии главного модуля 9.0.7 шаблоны были для функции eregi_replace. Начиная с указанной версии — preg_replace.
maxlen Вставляет тег <br/> через число символов, указанных в значении. Что бы запретить подстановку этого тега достаточно указать false. 5.9.3

 

 InsertSpaces

Разбивает длинные слова тексте. Возвращает текст в котором максимальная длина каждого слова не превышает заданной длины.

Параметры функции

Параметр Описание С версии
text Исходный текст.
max_length Максимальное количество символов в слове. Более длинные слова разбиваются символом заданным в параметре symbol.
symbol Символ которым будут разбиты слова длина которых превышает max_length. 4.0.6
HTML Необязательный. По умолчанию — «false». 9.5.0

 

 randString

Возвращает строку указанной длины, состоящую из случайных символов. Символами могут быть буквы английского алфавита и цифры. Функция может использоваться например, для генерации пароля.

Параметры функции

Параметр Описание С версии
pass_len Длина результирующей случайной строки.
Набор символов набор символов. Необязательный. По умолчанию: abcdefghijklnmopqrstuvwxyzABCDEFGHIJKLNMOPQRSTUVWXYZ01234567­89.может быть массивом классов символов и тогда в результирующую строчку войдет как минимум один символ из каждого класса.

Пример:

echo randString(7, array(
«abcdefghijklnmopqrstuvwxyz»,
«ABCDEFGHIJKLNMOPQRSTUVWX­YZ»,
«0123456789»,
«!@#\$%^&*()»,
));

7.1.0

 

 ToLower

Преобразует символы исходной строки в нижний регистр. Данная функция, помимо символов других алфавитов, корректно конвертирует кириллические символы (русские символы) в нижний регистр.

Примечание. Данную функцию можно использовать в случае если возникают проблемы с преобразованием кириллических символов стандартной PHP функцией strtolower. Иногда это происходит на некоторых хостингах.

Параметры функции

Параметр Описание С версии
text Исходная строка.
lang Идентификатор языка. 10.0.11

 

 ToUpper

Преобразует символы исходной строки в верхний регистр. Данная функция, помимо символов других алфавитов, корректно конвертирует кириллические символы (русские символы) в верхний регистр.

Примечание. Данную функцию можно использовать в случае если возникают проблемы с преобразованием кириллических символов стандартной PHP функцией strtoupper. Иногда это происходит на некоторых хостингах.

Параметры функции

Параметр Описание С версии
text Исходная строка.
lang Идентификатор языка. 10.0.11

 

 TrimEx

Удаляет из строки $str символ $symbol со стороны $side. Функция удаляет не более одного символа с каждой стороны.

Параметры функции

Параметр Описание
str Строка, откуда производится удаление
symbol Символы, подлежащие удалению
side С какой стороны удаление:

  • both — в начале и конце строки;
  • left — в начале строки;
  • right — в конце строки.

 

 TrimExAll

Удаляет все крайние символы $symbol в строке $str.

Параметры функции

Параметр Описание
str Строка, откуда производится удаление
symbol Символы, подлежащие удалению

 

 TruncateText

Отсекает от строки все символы свыше указанной длины. Если отсечение произошло, то к строке справа дописывается многоточие.

Параметры функции

Параметр Описание
text Исходная строка.
Len Длина конечной строки.

 

 TxtToHTML

Конвертирует обычный текст в HTML-код форматирующий исходный текст.

Параметры функции

Параметр Описание
text Исходный текст.
make_url Если значение «true», то — преобразовывать подстроки, которые представляют собой web-адреса (http://… или mailto:), в HTML ссылки.
Необязательный параметр. По умолчанию — «true».
max_string Максимальная длина слова. Все слова длиннее этого параметра разбиваются пробелами. Значение «0» — означает «не разбивать слова».
Необязательный параметр. По умолчанию — «0».
quote_tag_enabled Если значение — «Y», то спец. тег <QUOTE>…</QUOTE> (цитата) будет преобразован в HTML таблицу (визуально цитата будет обрамлена рамкой).
Необязательный параметр. По умолчанию — «N».
not_convert_amp Если значение — «Y», то «&» не будет преобразован «&amp;».
Необязательный параметр. По умолчанию — «Y».
code_tag_enabled Если значение — «Y», то спец. тег <CODE>…</CODE> (код) будет преобразован в HTML элемент textarea, в свою очередь обрамленный таблицей (визуально код будет обрамлен рамкой и выведен в textarea).
Необязательный параметр. По умолчанию — «N».
biu_tags_enabled Если значение — «Y», то спец. теги <b>…</b>, <i>…</i>, <u>…</u> будут преобразованы в соответствующие им HTML теги.
quote_table_class CSS класс на таблицу цитаты (<quote>).
Необязательный параметр. По умолчанию — «quotetable».
quote_head_class CSS класс на первую ячейку (TD) таблицы цитаты (<quote>).
Необязательный параметр. По умолчанию — «tdquotehead».
quote_body_class CSS класс на вторую ячейку (TD) таблицы цитаты (<quote>):

<table class=»quote_table_class»>
<tr>
<td class=»quote_head_class»> …
</td>
</tr>
<tr>
<td class=»quote_body_class»> …
</td>
</tr>
</table>

Необязательный параметр. По умолчанию — «tdquote».

code_table_class CSS класс на таблицу кода (<code>).
Необязательный параметр. По умолчанию — «codetable».
code_head_class CSS класс на первую TD таблицы кода (<code>).
Необязательный параметр. По умолчанию — «tdcodehead».
code_body_class CSS класс на вторую TD таблицы кода (<code>).
Необязательный параметр. По умолчанию — «tdcodebody».
code_textarea_class CSS класс на textarea в таблице кода (<code>):

<table class=»code_table_class»>
<tr>
<td class=»code_head_class»> … </td>
</tr>
<tr>
<td class=»code_body_class»>
<textarea class=»code_textarea_class»> …
</textarea>
</td>
</tr>
</table>

Необязательный параметр. По умолчанию — «codetextarea».

link_class CSS класс на ссылках:

<a class=»link_class»> … </a>

Необязательный параметр. По умолчанию — «txttohtmllink».

event В данном массиве можно задать идентификаторы типа события, которое будет фиксироваться при клике на HTML ссылке. Параметр работает, только если make_url == true.

Допустимы следующие ключи данного массива:

  • EVENT1 — идентификатор event1 типа события;
  • EVENT2 — идентификатор event2 типа события;
  • EVENT3 — идентификатор event3 типа события;
  • SCRIPT — путь относительно корня к скрипту фиксирующему событие и осуществляющему редирект.

 

 utf8win1251

Конвертирует строку из кодировки UTF-8 в кодировку Windows 1251.

Параметры функции

Параметр Описание
text Исходная строка.


Документация Битрикс

Добавить комментарий