Files
doc-fr/reference/xml/functions/utf8-decode.xml
2021-09-24 04:13:47 +01:00

125 lines
4.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.utf8-decode">
<refnamediv>
<refname>utf8_decode</refname>
<refpurpose>Convertit une chaîne UTF-8 en ISO-8859-1</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>utf8_decode</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
<function>utf8_decode</function> décode la chaîne
<parameter>string</parameter>, en supposant qu'elle est au format
<literal>UTF-8</literal>, et la convertit au format
<literal>ISO-8859-1</literal>. Les octets dans la chaîne qui ne sont pas
valides en <literal>UTF-8</literal> et les caractères <literal>UTF-8</literal>
qui n'existent pas en <literal>ISO-8859-1</literal> (qui sont, les caractères
au-dessus de <literal>U+00FF</literal>) sont remplacés par <literal>?</literal>.
</para>
<note>
<para>
De nombreuses pages Web marquées comme utilisant l'encodage de caratères
<literal>ISO-8859-1</literal> utilisent effectivement un encodage similaire
à <literal>Windows-1252</literal>, et les navigateurs Web interpréterons
les pages Web <literal>ISO-8859-1</literal> comme
<literal>Windows-1252</literal>. Les caractéristiques supplémentaires
de <literal>Windows-1252</literal> sont des caractères imprimables,
tels que le signe euro (<literal></literal>) et les guillemets bouclés
(<literal></literal> <literal></literal>), à la place de certains
caractères de contrôle de l'<literal>ISO-8859-1</literal>. Cette fonction
ne convertira pas ces caractères <literal>Windows-1252</literal>
correctement. Utilisez une fonction différente si une conversion
<literal>Windows-1252</literal> est nécessaire.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
La chaîne encodée UTF-8.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne la chaîne <parameter>string</parameter> convertie en ISO-8859-1.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.2.0</entry>
<entry>
Cette fonction a été déplacée dans le cœur de PHP ; auparavant, il était
nécessaire d'installer l'extension XML pour l'utiliser.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>utf8_encode</function> - Réalise la conversion inverse</member>
<member><function>mb_convert_encoding</function> - Convertit entre différents codages de caractères, y compris UTF-8, ISO-8859-1 et Windows-1252</member>
<member><function>iconv</function> - Convertit entre différents codages de caractères</member>
<member><function>recode_string</function> - Convertit entre différents codages de caractères</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
-->