©
本文档使用
php.cn手册 发布
“文本帮助”文件包含有助于处理文本的功能。
加载此助手
可用职能
加载此助手
使用以下代码加载此助手：
$this->load->helper('text');可用职能
现有下列职能：
word_limiter($str[, $limit = 100[, $end_char = '…']])
参数： | $ str（string） - 输入字符串$ limit（int） - 限制$ end_char（字符串） - 结束字符（通常为省略号） |
|---|---|
返回： | 字限制字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$ limit（int） - 限制
$ end_char（字符串） - 结束字符（通常是省略号）
Returns: Word-limited string
Return type: string
Truncates a string to the number of _words_ specified. Example:
$ string =“这是一个很好的文本字符串，由十一个字组成。”; $ string = word_limiter（$ string，4）; //返回：这是一个很好的
第三个参数是添加到字符串的可选后缀。默认情况下它会添加一个省略号。
character_limiter($str[, $n = 500[, $end_char = '…']])
参数： | $ str（string） - 输入字符串$ n（int） - 字符数$ end_char（字符串） - 结束字符（通常为省略号） |
|---|---|
返回： | 字符限制的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$ n（int） - 字符数
$ end_char（字符串） - 结束字符（通常是省略号）
Returns: Character-limited string
Return type: string
Truncates a string to the number of _characters_ specified. It maintains the integrity of words so the character count may be slightly more or less than what you specify.
例子：
$ string =“这是一个很好的文本字符串，由十一个字组成。”; $ string = character_limiter（$ string，20）; //返回：这是一个很好的文本字符串
第三个参数是添加到字符串中的可选后缀，如果未声明此助手使用省略号。
注
如果需要截断到确切的字符数，请参见ellipsize()职能如下。
ascii_to_entities($str)
参数： | $ str（string） - 输入字符串 |
|---|---|
返回： | ASCII值转换为实体的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串返回：将ASCII值转换为实体的字符串返回类型：字符串将ASCII值转换为字符实体，包括在网页中使用时可能导致问题的高位ASCII和MS Word字符，以便它们可以始终如一地显示，而不管浏览器设置如何或可靠地存储在数据库中 对服务器支持的字符集有一定的依赖性，因此它在所有情况下可能不是100％可靠，但大多数情况下它应该正确识别正常范围以外的字符（如重音字符）。例如：$ string = ascii_to_entities（$ string）;
convert_accented_characters($str)参数：$ str（string） - 输入stringReturns：带有重音字符的字符串convertedReturn类型：字符串
$ str（string） - 输入字符串
返回：转换了重音字符的字符串
Return type: string
将高位ASCII字符转换为低位ASCII等值。当只有标准ASCII字符被安全使用时，例如在URL中，需要使用非英文字符时非常有用。
例子：
$ string = convert_accented_characters（$ string）;
注
此函数使用配套配置文件。application/config/foreign_chars.php若要定义用于音译的往返数组，请执行以下操作。
word_censor($str, $censored[, $replacement = ''])
参数： | $ str（字符串） - 输入字符串$ censored（数组） - 坏字的列表审查$ replacement（字符串） - 什么用坏字代替 |
|---|---|
返回： | 审查字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$审查（数组） - 检查员的坏字的列表
$ replacement（string） - 用什么来替换不好的单词
Returns: Censored string
Return type: string
使您能够检查文本字符串中的单词。第一个参数将包含原始字符串。第二个将包含你不允许的单词数组。第三个（可选）参数可以包含单词的替换值。如果未指定，则用磅符号代替它们：####。
例子：
$ disallowed = array（'darn'，'shucks'，'golly'，'phooey'）; $ string = word_censor（$ string，$ disallowed，'Beep！'）;
highlight_code($str)
参数： | $ str（string） - 输入字符串 |
|---|---|
返回： | 通过HTML高亮显示代码的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串返回：通过HTML高亮显示代码的字符串返回类型：字符串将一串代码（PHP，HTML等）着色。例如：$ string = highlight_code（$ string）; 该函数使用PHP的
highlight_string()函数，所以使用的颜色是在php.ini文件中指定的颜色。highlight_phrase($str, $phrase[, $tag_open = '<mark>'[, $tag_close = '</mark>']])参数：$ str（string） - 输入字符串$ phrase（string） - 突出显示的语句$ tag_open（字符串） - 打开用于突出显示的标记$ tag_close（字符串） - highlightReturns的结束标记：带有通过HTML突出显示的短语的字符串返回类型：字符串
$ str（string） - 输入字符串
$ phrase（string） - 突出显示的短语
$ tag_open（字符串） - 打开用于突出显示的标记
$ tag_close（字符串） - 关闭突出显示的标记
Returns: String with a phrase highlighted via HTML
Return type: string
将突出显示文本字符串中的短语。第一个参数将包含原始字符串，第二个参数将包含您希望突出显示的短语。第三个和第四个参数将包含打开/关闭HTML标签，您希望包含该短语。
例子：
$ string =“这是一个很好的文本字符串，特别是没有什么特别的。echo highlight_phrase（$ string，“nice text”，'<span style =“color：＃990000;”>'，'</ span>'）;
以上代码打印：
这是一个<span style =“color：＃990000;”>漂亮的文本</ span>字符串，没有什么特别的。
注
此函数用于使用<strong>默认情况下标记。较旧的浏览器可能不支持新的HTML 5标记标记，因此如果需要支持以下CSS代码，建议将其插入样式表：
标记{背景：#ff0；颜色：#000；}；
word_wrap($str[, $charlim = 76])
参数： | $ str（string） - 输入字符串$ charlim（int） - 字符限制 |
|---|---|
返回： | 包裹字的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$ charlim（int） - 字符限制
Returns: Word-wrapped string
Return type: string
在保留完整单词的同时，在指定的_character_数处包装文本。
例子：
$ string =“这是一段简单的文本字符串，可以帮助我们演示这个功能。”; echo word_wrap（$ string，25）; //将生成：//这是一个简单的字符串//文本，它将帮助我们//演示此功能。
ellipsize($str, $max_length[, $position = 1[, $ellipsis = '…']])
参数： | $ str（string） - 输入字符串$ max_length（int） - 字符串长度限制$ position（mixed） - 在（int或float）处分割的位置$ ellipsis（string） - 用作省略字符 |
|---|---|
返回： | 椭圆化的字符串 |
返回类型： | 串 |
$ str（string） - 输入字符串
$ max_length（int） - 字符串长度限制
$ position（mixed） - 分割位置（int或float）
$ ellipsis（string） - 用作省略号字符的地方
Returns: Ellipsized string
Return type: string
This function will strip tags from a string, split it at a defined maximum length, and insert an ellipsis.
第一个参数是椭圆大小的字符串，第二个参数是最终字符串中的字符数。第三个参数是字符串中的省略号从0到1出现的位置，从左到右。例如。值为1会将省略号放在字符串的右侧，.5位于中间，而0位于左侧。
可选的FORTH参数是省略号的类型。默认情况下，...将被插入。
例子：
$ 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