doc-fr/reference/xml/functions/xml-set-processing-instruction-handler.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
  <refentry id="function.xml-set-processing-instruction-handler">
   <refnamediv>
    <refname>xml_set_processing_instruction_handler</refname>
    <refpurpose>
     Affecte les gestionnaires d'instructions exécutables
    </refpurpose>
   </refnamediv>
   <refsect1>
    &reftitle.description;
    <methodsynopsis>
     <type>bool</type><methodname>xml_set_processing_instruction_handler</methodname>
     <methodparam><type>resource</type><parameter>parser</parameter></methodparam>
     <methodparam><type>callback</type><parameter>handler</parameter></methodparam>
    </methodsynopsis>
    <para>
     <function>xml_set_processing_instruction_handler</function>
     affecte le gestionnaire d'instructions exécutables de l'analyseur
     XML <parameter>parser</parameter>. <parameter>handler</parameter> est une
     chaîne qui contient le nom d'une fonction qui existe lorsque
     <function>xml_parse</function> est appelé pour créer
     <parameter>parser</parameter>.
    </para>
    <para>
     Une instruction exécutable a la forme suivante :
     <example>
      <title>Structure d'instruction exécutable</title>
      <programlisting>&lt;?
       <replaceable>target</replaceable>
       <replaceable>data</replaceable>?&gt;
      </programlisting>
     </example>
     Vous pouvez mettre du code &php; entre ces balises, mais soyez conscient d'une
     des limitations des instructions exécutables de XML : la balise
     de fin d'instruction exécutable (<literal>?&gt;</literal>)
     ne peut être échappée, ce qui fait que cette
     séquence NE DOIT JAMAIS apparaître dans le code &php;
     placé dans le document &php;. Si un tel texte apparaît,
     la balise de fin d'instruction exécutable sera reconnue, et
     le reste du code sera considéré comme des données
     brutes (et donc, pas exécutées).
    </para>
    <para>
     La fonction <parameter>handler</parameter> doit accepter trois paramètres:
     <methodsynopsis>
      <methodname><replaceable>handler</replaceable></methodname>
      <methodparam><type>resource</type><parameter>parser</parameter></methodparam>
      <methodparam><type>string</type><parameter>target</parameter></methodparam>
      <methodparam><type>string</type><parameter>data</parameter></methodparam>
     </methodsynopsis>
     <variablelist>
      <varlistentry>
       <term><parameter>parser</parameter></term>
       <listitem>
        <simpara>
         Le premier paramètre, <replaceable>parser</replaceable>, est une
         référence sur l'analyseur XML qui appelle cette fonction.
        </simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><parameter>target</parameter></term>
       <listitem>
        <simpara>
         Le second paramètre, <parameter>target</parameter>,
         contient l'application cible.
        </simpara>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><parameter>data</parameter></term>
       <listitem>
        <simpara>
         Le troisième paramètre, <parameter>data</parameter>, contient
         le code sous la forme d'une chaîne.
        </simpara>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
    <para>
     Si un gestionnaire reçoit une chaîne vide, ou &false;,
     c'est qu'il est désactivé.
    </para>
    <para>
     <function>xml_set_processing_instruction_handler</function> retourne
     &true; si le gestionnaire est actif, et
     &false; sinon, ou si <parameter>parser</parameter>
     n'est pas un analyseur.
    </para>
    &note.func-callback;
   </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
-->