# htmlspecialchars_decode

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

htmlspecialchars_decode — Convertit les entités HTML spéciales en caractères

### Description

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

Cette fonction est l'opposée de htmlspecialchars(). Elle convertit les entités HTML spéciales en caractères.

Les entités converties sont : `&amp;`, `&quot;` (lorsque `ENT_NOQUOTES` n'est pas activée), `&#039;` (lorsque `ENT_QUOTES` est activée), `&lt;` et `&gt;`.

### Liste de paramètres

`string`

  La chaîne de caractères à décoder

`flags`

  Un masque d'un ou plusieurs drapeaux suivants, qui spécifient la façon dont doit être géré les guillemets et quel type de document à utiliser. Par défaut, c'est `ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401`.

  Constantes pour le paramètre `flags` disponibles
  Nom de la Constante | Description
  --- | ---
  `ENT_COMPAT` | Convertira les guillemets et laissera les apostrophes.
  `ENT_QUOTES` | Convertira les guillemets et les apostrophes.
  `ENT_NOQUOTES` | Laissera les guillemets et les apostrophes non convertis.
  `ENT_SUBSTITUTE` | Remplace les séquences de code invalide avec un caractère de remplacement Unicode U+FFFD (UTF-8) ou &#FFFD; (sinon) au lieu de retourner une chaîne vide.
  `ENT_HTML401` | Gère le code comme étant du HTML 4.01.
  `ENT_XML1` | Gère le code comme étant du XML 1.
  `ENT_XHTML` | Gère le code comme étant du XHTML.
  `ENT_HTML5` | Gère le code comme étant du HTML 5.

### Valeurs de retour

Retourne la chaîne de caractères décodée.

### Historique

Version | Description
--- | ---
8.1.0 | `flags` à changé de `ENT_COMPAT` à `ENT_QUOTES` | `ENT_SUBSTITUTE` | `ENT_HTML401`.

### Exemples

Exemple #1 Exemple avec htmlspecialchars_decode()

`<?php
$str = "<p>this -&gt; &quot;</p>\n";
echo htmlspecialchars_decode($str);
// notez ici que les guillemets ne sont pas convertis
echo htmlspecialchars_decode($str, ENT_NOQUOTES);
?>`

L'exemple ci-dessus va afficher :

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

### Voir aussi

- htmlspecialchars() - Convertit les caractères spéciaux en entités HTML
- html_entity_decode() - Convertit les entités HTML à leurs caractères correspondant
- get_html_translation_table() - Retourne la table de traduction des entités utilisée par htmlspecialchars et htmlentities