文本助手 | Text Helper

文本助手

“文本帮助”文件包含有助于处理文本的功能。

• 加载此助手

• 可用职能

加载此助手

使用以下代码加载此助手：

$this->load->helper('text'

可用职能

现有下列职能：

word_limiter($str[, $limit = 100[, $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（字符串） - 结束字符（通常是省略号）

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值转换为实体的字符串返回类型：字符串将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（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高亮显示代码的字符串返回类型：字符串将一串代码（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） - 字符限制

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） - 用作省略号字符的地方

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