# 排版辅助函数 排版辅助函数文件包含了文本排版相关的一些函数。 [TOC=2,3] ## [加载辅助函数](http://codeigniter.org.cn/user_guide/helpers/typography_helper.html#id4) 该辅助函数通过下面的代码加载: ~~~ $this->load->helper('typography'); ~~~ ## [可用函数](http://codeigniter.org.cn/user_guide/helpers/typography_helper.html#id5) 该辅助函数有下列可用函数： auto_typography($str[, $reduce_linebreaks = FALSE]) 参数: * **$str** (string) -- Input string * **$reduce_linebreaks** (bool) -- Whether to reduce multiple instances of double newlines to two 返回: HTML-formatted typography-safe string 返回类型: string 格式化文本以便纠正语义和印刷错误的 HTML 代码。 这个函数是 CI_Typography::auto_typography 函数的别名。 更多信息，查看 [排版类](http://codeigniter.org.cn/user_guide/libraries/typography.html) 。 Usage example: ~~~ $string = auto_typography($string); ~~~ 注解 格式排版可能会消耗大量处理器资源，特别是在排版大量内容时。 如果你选择使用这个函数的话，你可以考虑使用 缓存 。 nl2br_except_pre($str) 参数: * **$str** (string) -- Input string 返回: String with HTML-formatted line breaks 返回类型: string 将换行符转换为 标签，忽略 标签中的换行符。除了对 标签中的换行处理有所不同之外，这个函数和 PHP 函数 nl2br() 是完全一样的。 使用示例: ~~~ $string = nl2br_except_pre($string); ~~~ entity_decode($str, $charset = NULL) 参数: * **$str** (string) -- Input string * **$charset** (string) -- Character set 返回: String with decoded HTML entities 返回类型: string 这个函数是 CI_Security::entity_decode() 函数的别名。 更多信息，查看 [安全类](http://codeigniter.org.cn/user_guide/libraries/security.html) 。