archived-doc-es/reference/xml/functions/xml-set-start-namespace-decl-handler.xml

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

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>xml_set_start_namespace_decl_handler</methodname>
   <methodparam><type>resource</type><parameter>parser</parameter></methodparam>
   <methodparam><type>callable</type><parameter>handler</parameter></methodparam>
  </methodsynopsis>
  <para>
   Configura un manejador para ser llamado cuando un namespace es declarado. La declaración de namespace 
   ocurre dentro de las etiquetas de inicio. Sin embargo, el manejador inicial de declaración
   del namespace es llamado antes del manejador de etiqueta inicial para cada namespace declarado 
   en esa etiqueta de inicio.
  </para>
 </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 
       tres 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>resource</type><parameter>parser</parameter></methodparam>
        <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
        <methodparam><type>string</type><parameter>uri</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>
        <varlistentry>
         <term><parameter>uri</parameter></term>
         <listitem>
          <simpara>
           Identificador de Recurso Uniforme (URI, por sus siglas en inglés) del namespace.
          </simpara>
         </listitem>
        </varlistentry>
       </variablelist>
      </para>
      <para>
       Si una 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="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>xml_set_end_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
-->