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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3db49ee0a331a657dd97b539a749f53d3965b593 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.xml-set-processing-instruction-handler" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>xml_set_processing_instruction_handler</refname>
  <refpurpose>Affecte les gestionnaires d'instructions exécutables</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>xml_set_processing_instruction_handler</methodname>
   <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
   <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
  </methodsynopsis>
  <para>
   Affecte le gestionnaire d'instructions exécutables de l'analyseur
   XML <parameter>parser</parameter>.
  </para>
  <para>
   Une instruction exécutable a la forme suivante :
   <informalexample>
    <programlisting>&lt;?<replaceable>target</replaceable>
     <replaceable>data</replaceable>?&gt;
    </programlisting>
   </informalexample>
   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>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>parser</parameter></term>
     <listitem>
      <para>
       Une référence à l'analyseur XML à définir comme fonction
       d'analyse d'instructions (PI).
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>handler</parameter></term>
     <listitem>
      <para>
       <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>
       La fonction <parameter>handler</parameter> doit accepter trois paramètres :
       <methodsynopsis>
        <methodname><replaceable>handler</replaceable></methodname>
        <methodparam><type>XMLParser</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, <parameter>parser</parameter>, 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>
      &note.func-callback;
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

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

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
      &xml.changelog.parser-param;
    </tbody>
   </tgroup>
  </informaltable>
 </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
-->