mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-24 17:02:18 +01:00
230 lines
7.1 KiB
XML
230 lines
7.1 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- EN-Revision: eabde0419cf90f596f60db00e31fcb6ebe41ac55 Maintainer: yannick Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
<refentry xml:id="function.html-entity-decode" xmlns="http://docbook.org/ns/docbook">
|
|
<refnamediv>
|
|
<refname>html_entity_decode</refname>
|
|
<refpurpose>Convertit les entités HTML à leurs caractères correspondant</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<type>string</type><methodname>html_entity_decode</methodname>
|
|
<methodparam><type>string</type><parameter>string</parameter></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401</initializer></methodparam>
|
|
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
<function>html_entity_decode</function> est la fonction contraire de
|
|
<function>htmlentities</function> : elle convertit les entités HTML de
|
|
la chaîne <parameter>string</parameter> en leurs caractères correspondant.
|
|
</para>
|
|
<para>
|
|
De façon plus explicite, cette fonction décode toutes les entités (incluant
|
|
les entités numériques) qui 1) sont nécessairement valides pour le type
|
|
de document choisi - i.e., pour XML, cette fonction ne décode pas les
|
|
entités nommées qui peuvent être définies dans une DTD - et 2) et dont le caractère
|
|
ou les caractères sont dans le jeu de caractères codé avec l'encodage choisi et
|
|
sont autorisés dans le type de document choisi. Toutes les autres entités
|
|
sont laissées telle que.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><parameter>string</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
La chaîne d'entrée.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>flags</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Un masque d'un ou plusieurs drapeaux suivants, qui spécifient la façon
|
|
dont doivent être gérés les guillemets et quel type de document doit être utilisé.
|
|
Par défaut, c'est <literal>ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401</literal>.
|
|
<table>
|
|
<title>Constantes disponibles pour <parameter>flags</parameter></title>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>Constante</entry>
|
|
<entry>Description</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><constant>ENT_COMPAT</constant></entry>
|
|
<entry>Convertit les guillemets doubles et ignore les guillemets simples.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_QUOTES</constant></entry>
|
|
<entry>Convertit les guillemets doubles et les guillemets simples.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_NOQUOTES</constant></entry>
|
|
<entry>Ne convertit aucun guillemet.</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_SUBSTITUTE</constant></entry>
|
|
<entry>
|
|
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.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_HTML401</constant></entry>
|
|
<entry>
|
|
Gère le code comme étant du HTML 4.01.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_XML1</constant></entry>
|
|
<entry>
|
|
Gère le code comme étant du XML 1.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_XHTML</constant></entry>
|
|
<entry>
|
|
Gère le code comme étant du XHTML.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry><constant>ENT_HTML5</constant></entry>
|
|
<entry>
|
|
Gère le code comme étant du HTML 5.
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>encoding</parameter></term>
|
|
<listitem>
|
|
&strings.parameter.encoding;
|
|
&reference.strings.charsets;
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="returnvalues">
|
|
&reftitle.returnvalues;
|
|
<para>
|
|
Retourne la chaîne décodée.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>8.1.0</entry>
|
|
<entry>
|
|
<parameter>flags</parameter> à changé de <constant>ENT_COMPAT</constant> à
|
|
<constant>ENT_QUOTES</constant> | <constant>ENT_SUBSTITUTE</constant> | <constant>ENT_HTML401</constant>.
|
|
</entry>
|
|
</row>
|
|
<row>
|
|
<entry>8.0.0</entry>
|
|
<entry>
|
|
<parameter>encoding</parameter> est désormais nullable.
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</refsect1>
|
|
|
|
<refsect1 role="examples">
|
|
&reftitle.examples;
|
|
<para>
|
|
<example>
|
|
<title>Décoder des entités HTML</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$orig = 'J\'ai "sorti" le <strong>chien</strong> tout à l\'heure';
|
|
$a = htmlentities($orig);
|
|
$b = html_entity_decode($a);
|
|
|
|
echo $a; // J'ai "sorti" le <strong>chien</strong> tout &agrave; l'heure
|
|
echo $b; // J'ai "sorti" le <strong>chien</strong> tout à l'heure
|
|
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="notes">
|
|
&reftitle.notes;
|
|
<note>
|
|
<para>
|
|
Vous pourriez vous demander pourquoi
|
|
<literal>trim(html_entity_decode('&nbsp;'));</literal>
|
|
ne réduit pas la chaîne à la chaîne vide. C'est parce
|
|
que l'entité <literal>&nbsp;</literal>
|
|
n'est pas un code ASCII 32 (qui serait supprimé par
|
|
<function>trim</function>), mais un code ASCII 160 (<literal>0xa0</literal>)
|
|
dans l'encodage par défaut <literal>ISO 8859-1</literal>.
|
|
</para>
|
|
</note>
|
|
</refsect1>
|
|
|
|
<refsect1 role="seealso">
|
|
&reftitle.seealso;
|
|
<para>
|
|
<simplelist>
|
|
<member><function>htmlentities</function></member>
|
|
<member><function>htmlspecialchars</function></member>
|
|
<member><function>get_html_translation_table</function></member>
|
|
<member><function>urldecode</function></member>
|
|
</simplelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|