[PHP-DOC] cvs: phpdoc /fr/functions iconv.xml

[Damien Seguy]

dams            Fri Jul 20 03:06:30 2001 EDT

  Added files:                 
    /phpdoc/fr/functions        iconv.xml 
  Log:
  initial transaltion
  

Index: phpdoc/fr/functions/iconv.xml
+++ phpdoc/fr/functions/iconv.xml
 <reference id="ref.iconv">
  <title>Iconv</title>
  <titleabbrev>iconv</titleabbrev>
  <partintro>
   <para>
    Ce module est une interface vers la librairie iconv. Pour pouvoir l'utiliser,
    vous devez compiler PHP avec l'option
    <link linkend="install.configure.with-iconv"><option 
role="configure">--with-iconv</option></link>.
    Pour cela, vous devez avoir la fonction iconv() dans votre librairie
    standard C, ou bien la librairie libiconv install&eacute;e sur votre 
syst&egrave;me.
    La librairie libiconv est disponible &agrave;
    <ulink url="&url.libiconv;">&url.libiconv;</ulink>.
   </para>
   <para>
    L'extension iconv convertit des fichiers entre divers jeux de caract&egrave;res.
    Les jeux support&eacute;s d&eacute;pendent de l'impl&eacute;mentation de iconv() 
sur votre
    syst&egrave;me. Notez que cette fonction ne fonctionne pas toujours bien
    sur tous les syst&egrave;mes. Dans ce cas, vous devez installer la librairie
    tout de m&ecirc;me.
   </para>
  </partintro>
  <refentry id="function.iconv">
   <refnamediv>
    <refname>iconv</refname>
    <refpurpose>Convertit une cha&icirc;ne dans un jeu de 
caract&egrave;res</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>iconv</function></funcdef>
      <paramdef>string <parameter>in_charset</parameter></paramdef>
      <paramdef>string <parameter>out_charset</parameter></paramdef>
      <paramdef>string <parameter>str</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>iconv</function> convertit la cha&icirc;ne <parameter>string</parameter>
     depuis le jeu de caract&egrave;res <parameter>in_charset</parameter> vers le jeu
     de caract&egrave;res <parameter>out_charset</parameter>. Elle retourne la 
cha&icirc;ne
     ainsi convertie, ou bien <literal>FALSE</literal>, en cas d'&eacute;chec.
    </para>
    <para>
     <example>
      <title>Exemple avec <function>iconv</function></title>
      <programlisting role="php">
&lt;?php
  echo iconv("ISO-8859-1","UTF8","Ceci est un test.");
?&gt;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.iconv-get-encoding">
   <refnamediv>
    <refname>iconv_get_encoding</refname>
    <refpurpose>
     Lit le jeu de caract&egrave;res courant
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>iconv_get_encoding</function></funcdef>
      <paramdef>string
       <parameter><optional>type</optional></parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>iconv_get_encoding</function> retourne le param&egrave;trage courant du
     gestionnaire <function>ob_iconv_handler</function>, sous la forme d'un tableau,
     ou bien <literal>FALSE</literal>, en cas d'&eacute;chec.
    </para>
    <para>
     Voir aussi
     <function>iconv_set_encoding</function> et
     <function>ob_iconv_handler</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.iconv-set-encoding">
   <refnamediv>
    <refname>iconv_set_encoding</refname>
    <refpurpose>
     Modifie le jeu courant de caract&egrave;res courant
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>iconv_set_encoding</function></funcdef>
      <paramdef>string <parameter>type</parameter></paramdef>
      <paramdef>string <parameter>charset</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>iconv_set_encoding</function> modifie le jeu de caract&egrave;res 
courant,
     et remplace la valeur courante du param&eacute;tre <parameter>type</parameter> par
     <parameter>charset</parameter> et <literal>TRUE</literal> en cas de succ&egrave;s
     et <literal>FALSE</literal>, en cas d'&eacute;chec.
    </para>
    <para>
     <example>
      <title>Exemple <function>iconv_set_encoding</function></title>
      <programlisting role="php">
&lt;?php
  iconv_set_encoding("internal_encoding", "UTF-8");
  iconv_set_encoding("output_encoding", "ISO-8859-1");
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi
     <function>iconv_get_encoding</function> et
     <function>ob_iconv_handler</function>.
    </para>
   </refsect1>
  </refentry>
  <refentry id="function.ob-iconv-handler">
   <refnamediv>
    <refname>ob_iconv_handler</refname>
    <refpurpose>
     Gestionnaire de sortie pour maitriser le jeu de caract&egrave;res de sortie
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>ob_iconv_handler</function></funcdef>
      <paramdef>string
       <parameter>contents</parameter>
      </paramdef>
      <paramdef>int
       <parameter>status</parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     <function>ob_iconv_handler</function> convertit la cha&icirc;ne utilisant
     le jeu de caract&egrave;res <parameter>internal_encoding</parameter> en
     une cha&icirc;ne utilisant le jeu de caract&egrave;res 
<parameter>output_encoding</parameter>.
    </para>
    <para>
     <parameter>internal_encoding</parameter> et
     <parameter>output_encoding</parameter> doivent &ecirc;tre d&eacute;finis par
     <function>iconv_set_encoding</function> ou dans le fichier de configuration.
    </para>
    <para>
     <example>
      <title>Exemple avec <function>ob_iconv_handler</function></title>
      <programlisting role="php">
&lt;?php
  ob_start("ob_iconv_handler"); // start output buffering
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Voir aussi
     <function>iconv_get_encoding</function> et
     <function>iconv_set_encoding</function>.
    </para>
   </refsect1>
  </refentry>
 </reference>
<!-- 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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->