doc-fr/reference/unicode/functions/unicode-set-error-mode.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.unicode-set-error-mode">
 <refnamediv>
  <refname>unicode_set_error_mode</refname>
  <refpurpose>Définit le mode d'erreur pour la conversion de données</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>unicode_set_error_mode</methodname>
   <methodparam><type>int</type><parameter>direction</parameter></methodparam>
   <methodparam><type>int</type><parameter>mode</parameter></methodparam>
  </methodsynopsis>
  <para>
   Cette fonction définit le mode d'erreur lors de la conversion de chaînes
   entre différents encodages. Une erreur peut survenir lors de la conversion
   lorsqu'un caractère illégal est rencontré ou si un caractère ne peut
   être représenté dans le nouvel encodage. Par défaut, lorsqu'une erreur
   survient, la conversion s'arrête.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>direction</parameter></term>
     <listitem>
      <para>
       Le paramètre <parameter>direction</parameter> définit le sens de conversion
       dans lequel le mode d'erreur sera appliqué. Peut être soit
       <constant>FROM_UNICODE</constant>, qui définira le mode d'erreur
       pour les conversions depuis une chaîne <type>unicode</type> vers
       une chaîne binaire, ou <constant>TO_UNICODE</constant>, qui définira
       le mode d'erreur pour les conversions depuis une chaîne binaire
       vers une chaîne <type>unicode</type>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       <parameter>mode</parameter> détermine la façon dont les erreurs de
       conversion seront gérées. Peut être une des constantes suivantes :
      </para>
      <para>
       <table>
        <title>Modes disponibles</title>
        <tgroup cols="2">
         <thead>
          <row>
           <entry>Mode</entry>
           <entry>Description</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry>
            <constant>U_CONV_ERROR_STOP</constant>
           </entry>
           <entry>
            Arrête la conversion. C'est le mode par défaut.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_SKIP</constant>
           </entry>
           <entry>
            Ignore le caractère.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_SUBST</constant>
           </entry>
           <entry>
            Substitue le caractère. Le caractère de substitution peut être définit
            avec la fonction <function>unicode_set_subst_char</function>.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_ESCAPE_UNICODE</constant>
           </entry>
           <entry>
            Protège l'octet posant problème et le représente dans un format Unicode.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_ESCAPE_ICU</constant>
           </entry>
           <entry>
            Protège l'octet posant problème et le représente dans le format ICU.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_ESCAPE_JAVA</constant>
           </entry>
           <entry>
            Protège l'octet posant problème et l'affiche dans le format Java.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_ESCAPE_XML_DEC</constant>
           </entry>
           <entry>
            Protège l'octet posant problème et le représentant dans le format décimal.
           </entry>
          </row>
          <row>
           <entry>
            <constant>U_CONV_ERROR_ESCAPE_XML_HEX</constant>
           </entry>
           <entry>
            Protège l'octet posant problème et le représentant dans le format hexadécimal.
           </entry>
          </row>
         </tbody>
        </tgroup>
       </table>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Émet une erreur de niveau <constant>E_WARNING</constant> si la direction
   ou le mode est invalide.
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  &warn.experimental.func;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>unicode_encode</function></member>
    <member><function>unicode_decode</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:"../../../../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
-->