htmlspecialchars_decode

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

htmlspecialchars_decode — Converte entidades especiais HTML de volta para caracteres

Descrição

htmlspecialchars_decode(string $string, int $flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401): string

Esta função é oposta a htmlspecialchars(). Ela converte de volta entidade especiais HTML em caracteres.

As entidades convertidas são: &, " (quando ENT_NOQUOTES não estiver definida), ' (quando ENT_QUOTES estiver definida), < e >.

Parâmetros

string

A string a ser decodificada.

flags

Uma máscara de bits de uma ou mais das opções a seguir, que especificam como lidar com aspas e que tipos de documentos são usados. O padrão é ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

Constantes disponíveis para flags
Nome da Constante Descrição
ENT_COMPAT Converte aspas duplas e não converte aspas simples.
ENT_QUOTES Converte tanto aspas duplas quanto simples.
ENT_NOQUOTES Não converte aspas duplas ou simples.
ENT_SUBSTITUTE Substitui sequências de unidade de código inválidas com um Caractere de Substituição Unicode U+FFFD (UTF-8) ou � ao invés de retornar uma string vazia.
ENT_HTML401 Lida com o código como HTML 4.01.
ENT_XML1 Lida com o código como XML 1.
ENT_XHTML Lida com o código como XHTML.
ENT_HTML5 Lida com o código como HTML 5.

Valor Retornado

Retorna a string decodificada.

Registro de Alterações

Versão Descrição
8.1.0 O padrão de flags mudou de ENT_COMPAT para ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

Exemplos

Example #1 Um exemplo de htmlspecialchars_decode()

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

echo htmlspecialchars_decode($str);

// observe que aqui as aspas não são convertidas
echo htmlspecialchars_decode($str, ENT_NOQUOTES);
?>

O exemplo acima produzirá:

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

Veja Também