# htmlspecialchars_decode

(PHP 5 >= 5.1.0, PHP 7)

htmlspecialchars_decode — 将特殊的 HTML 实体转换回普通字符

### 说明

htmlspecialchars_decode ( string `$string` [, int `$flags` = ENT_COMPAT | ENT_HTML401 ] ) : string

此函数的作用和 htmlspecialchars() 刚好相反。它将特殊的HTML实体转换回普通字符。

被转换的实体有： &amp;， &quot; （没有设置`ENT_NOQUOTES` 时）, &#039; （设置了 `ENT_QUOTES` 时）， &lt; 以及&gt;。

### 参数

`string`

  要解码的字符串

`flags`

  用下列标记中的一个或多个作为一个位掩码，来指定如何处理引号和使用哪种文档类型。默认为 ENT_COMPAT | ENT_HTML401。

  有效的 `flags` 常量
  常量名 | 说明
  --- | ---
  `ENT_COMPAT` | 转换双引号，不转换单引号。
  `ENT_QUOTES` | 单引号和双引号都转换。
  `ENT_NOQUOTES` | 单引号和双引号都不转换。
  `ENT_HTML401` | 作为HTML 4.01编码处理。
  `ENT_XML1` | 作为XML 1编码处理。
  `ENT_XHTML` | 作为XHTML编码处理。
  `ENT_HTML5` | 作为HTML 5编码处理。

### 返回值

返回解码后的字符串。

### 更新日志

版本 | 说明
--- | ---
5.4.0 | 增加了 `ENT_HTML401`、`ENT_XML1`、 `ENT_XHTML` 和 `ENT_HTML5` 等常量。

### 范例

Example #1 一个 htmlspecialchars_decode() 的例子

    <?php
    $str = "<p>this -&gt; &quot;</p>\n";

    echo htmlspecialchars_decode($str);

    // 注意，这里的引号不会被转换
    echo htmlspecialchars_decode($str, ENT_NOQUOTES);
    ?>

以上例程会输出：

    <p>this -> "</p>
    <p>this -> &quot;</p>

### 参见

- htmlspecialchars() - 将特殊字符转换为 HTML 实体
- html_entity_decode() - Convert HTML entities to their corresponding characters
- get_html_translation_table() - 返回使用 htmlspecialchars 和 htmlentities 后的转换表