Помощник 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 в эквиваленты, полезно с неанглийскими символами, когда они должны использоваться там, где могут безопасно использоваться только английские, например в 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, etc.). Пример:
$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>');
The above text returns:
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);
// Would produce:
Here is a simple string
of text that will help
us demonstrate this
function
ellipsize()
Эта фунция удалит теги из строки, обрежет ее до указанной максимальной длины, и добавит многоточие.
Первый параметр - это строка, второй — количество символов. Третий параметр, установленный в 0, 0.5 или 1, укажет на положение многоточия. Например, значение 1 указывает на размещение многоточия справа, 0.5 — посередине, 0 — слева.
Четвертый опциональный параметр указывает разновидность многоточия, по умолчанию ….
$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