Получите помощь, поддержку и профессиональное общение в Клубе CodeIgniter

# CodeIgniter User Guide Version 2.1.0

Search User Guide

# Помощник Text

Помощник Text содержит функции, которые помогают в работе с текстом.

## Загрузка этого помощника

Этот помощник загружается посредством следующего кода:

`$this->load->helper('text');`

Доступны следующие функции:

## word_limiter()

Усекает строку до указанного количества слов. Пример:

`$string = "Here is a nice text string consisting of eleven words.";
$string = word_limiter($string, 4);
// Возвращает: Here is a nice…`

Третий параметр это опциональный суффикс, добавляемый к строке. По умолчанию добавляется многоточие.

## character_limiter()

Усекает строку до указанного количества символов. Функция поддерживает целостность слов, так что количество символов может быть больше или меньше, чем вы указываете. Пример:

`$string = "Here is a nice text string consisting of eleven words.";
$string = character_limiter($string, 20);
// Возвращает: Here is a nice text string…`

Третий параметр — это опциональный суффикс, добавляемый к строке. Если не указывается, по умолчанию используется многоточие.

## ascii_to_entities()

Конвертирует значения ASCII в символьные соответствия, включая старшие символы ASCII и символы MS Word, которые, как известно, могут создать известные проблемы при использовании на веб-странице. После конвертации они могут безопасно отображаться на веб-страницах и храниться в базе данных. Есть некоторые зависимости от поддерживаемых сервером кодировок, поэтому функция не может быть надежной в 100% случаев, но по большей части она должна правильно определять символы вне нормального диапазона (такие, как символы акцентов). Пример:

`$string = ascii_to_entities($string);`

## entities_to_ascii()

Эта функция противоположна предыдущей. Она превращает сущности в ASCII.

## convert_accented_characters()

Делает транслитерацию старших символов ASCII в младшие эквиваленты. Полезно для неанглийских символов, которые должны использоваться в стандартном ASCII для безопасного использования. Например, в URL.

`$string = convert_accented_characters($string);`

Эта функция использует компаньонский конфигурационный файл application/config/foreign_chars.php, для определения массива транслитерации.

## word_censor()

Позволяет вам цензурировать слова в строке. Первый параметр содержит оригинальную строку. Второй параметр содержит массив запрещенных слов. Третий опциональный параметр может содержать значение, на которое следует заменять слова. Если не указано, используются знаки: ####. Пример:

`$disallowed = array('darn', 'shucks', 'golly', 'phooey');
$string = word_censor($string, $disallowed, 'Beep!');`

## highlight_code()

Расцвечивает строки кода (PHP, HTML и т.д.). Пример:

`$string = highlight_code($string);`

Эта функция использует функцию PHP highlight_string(), которая использует цвета, указанные в файле php.ini.

## highlight_phrase()

Подсвечивает фразу в строке текста. Первый параметр содержит оригинальную строку, второй содержит фразу, которую следует подсветить. Третий и четвертый параметр содержат HTML-теги, в которые будет вписана фраза. Пример:

`$string = "Here is a nice text string about nothing in particular.";
$string = highlight_phrase($string, "nice text", '<span style="color:#990000">', '</span>');`

Пример выше вернет:

Here is a nice text string about nothing in particular.

## word_wrap()

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

`$string = "Here is a simple string of text that will help us demonstrate this function.";
echo word_wrap($string, 25);
// Сделает:
Here is a simple string
of text that will help
us demonstrate this
function`

## ellipsize()

Эта функция вырежет теги из строки, разъединит ее в соответствии с указанной максимальной длинной, и добавит многоточие.

Первый параметр это исходная строка, второй это количество символов в финальной строке. Третий параметр это положение многоточия, от 0 до 1, что означает левый и правый концы. Например, значение 1 поместит многоточие справа от сроки, .5 посередине, и 0 слева.

Четвертый опциональный параметр это вид многоточия. По умолчанию будет использовано `&hellip;`.

`$str = 'this_string_is_entirely_too_long_and_might_break_my_design.jpg';
echo ellipsize($str, 32, .5);
// Сделает 'this_string_is_e…ak_my_design.jpg'`

### Поделиться

Переведено в компании Аринт.

# Спасибо!

Вы тоже можете оказать помощь проекту! Как это сделать?

## Помощь и поддержка

Вы можете задать вопросы и получить ответы и советы от гуру CodeIgniter и веб-разработки: вступайте в Клуб CodeIgniter