xml-set-end-namespace-decl-handler.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3db49ee0a331a657dd97b539a749f53d3965b593 Maintainer: carlos Status: ready -->
<refentry xml:id="function.xml-set-end-namespace-decl-handler" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>xml_set_end_namespace_decl_handler</refname>
  <refpurpose>Configura el manejador de declaración de final del namespace</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>xml_set_end_namespace_decl_handler</methodname>
   <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
   <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
  </methodsynopsis>
  <para>
   Configura un manejador para ser llamado cuando se salga del alcance
   de una declaración de namespace. Se llamará por cada declaración de namespace,
   después del manejador de etiqueta final del elemento en el cual el namespace fue declarado.
  </para>
  <caution>
   <para>
    Este evento no es compatible con libXML,
    por lo que no se llamaría a un controlador registrado.
   </para>
  </caution>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>parser</parameter></term>
     <listitem>
      <para>
       Identificador del recurso del intérprete XML.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>handler</parameter></term>
     <listitem>
      <para>
       <parameter>handler</parameter> es una cadena que contiene el nombre de
       una función que debe existir cuando <function>xml_parse</function> es llamado
       por <parameter>parser</parameter>.
      </para>
      <para>
       La función llamada mediante <parameter>handler</parameter> debe aceptar
       dos parámetros, y deberia devolver un número entero. Si el valor devuelto
       desde el manejador es &false; (lo cual ocurrirá si no
       se devulve un valor), el intérprete XML detendrá el analizado y
       <function>xml_get_error_code</function> devolverá
       <constant>XML_ERROR_EXTERNAL_ENTITY_HANDLING</constant>.
       <methodsynopsis>
        <methodname><replaceable>handler</replaceable></methodname>
        <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
        <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
       </methodsynopsis>
       <variablelist>
        <varlistentry>
         <term><parameter>parser</parameter></term>
         <listitem>
          <simpara>
           El primer parámetro, <replaceable>parser</replaceable>, es una
           referencia al intérprete XML que llama al manejador.
          </simpara>
         </listitem>
        </varlistentry>
        <varlistentry>
         <term><parameter>prefix</parameter></term>
         <listitem>
          <simpara>
           El prefijo es una cadena que se utiliza para hacer referencia al namespace dentro de un objeto XML.
          </simpara>
         </listitem>
        </varlistentry>
       </variablelist>
      </para>
      <para>
       Si la función del manejador se configura como una cadena vacía, o &false;, el manejador
       en cuestión es deshabilitado.
      </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>

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