©
このドキュメントでは、 php中国語ネットマニュアル リリース
“文本帮助”文件包含有助于处理文本的功能。
加载此助手
可用职能
使用以下代码加载此助手:
$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