Фреймворк CodeIgniter Version 2.1.3


Помощник 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'
    Поддержать сайт на родительском проекте КГБ