-
Notifications
You must be signed in to change notification settings - Fork 58
/
Copy pathxml-set-unparsed-entity-decl-handler.xml
168 lines (161 loc) · 5.81 KB
/
xml-set-unparsed-entity-decl-handler.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3db49ee0a331a657dd97b539a749f53d3965b593 Maintainer: carlos Status: ready -->
<refentry xml:id="function.xml-set-unparsed-entity-decl-handler" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>xml_set_unparsed_entity_decl_handler</refname>
<refpurpose>Configura el manejador de declaración de entidades no analizadas</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>xml_set_unparsed_entity_decl_handler</methodname>
<methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
<methodparam><type>callable</type><parameter>handler</parameter></methodparam>
</methodsynopsis>
<para>Configura la función del manejador de declaración de entidades no analizadas para el intérprete XML <parameter>parser</parameter>.
</para>
<para>
El <parameter>handler</parameter> será llamado si el intérprete XML encuentra una declaración de entidad externa con una declaración NDATA, como la siguiente:
<programlisting role="xml">
<![CDATA[
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
NDATA <parameter>notationName</parameter>
]]>
</programlisting>
</para>
<para>
Para la definición de notación de NDATA ver <link xlink:href="&url.rec-xml;#sec-external-ent">sección 4.2.2 de las especificaciones XML 1.0</link>.
</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 el que se va a configurar la función del manejador de declaración de entidades no analizadas.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>handler</parameter></term>
<listitem>
<para>
<parameter>handler</parameter> es un string 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 seis parámetros: <methodsynopsis>
<methodname><replaceable>handler</replaceable></methodname>
<methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>entity_name</parameter></methodparam>
<methodparam><type>string</type><parameter>base</parameter></methodparam>
<methodparam><type>string</type><parameter>system_id</parameter></methodparam>
<methodparam><type>string</type><parameter>public_id</parameter></methodparam>
<methodparam><type>string</type><parameter>notation_name</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
El primer parámetro, <replaceable>parser</replaceable>, hace referencia al intérprete XML que llama al manejador.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>entity_name</parameter></term>
<listitem>
<simpara>
El nombre de la entidad que está a punto de definirse.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<simpara>
Esta es la base para resolver el identificador de sistema (<parameter>system_id</parameter>) de la declaración de notación. Actualmente este parámetro siempre se establecerá como una cadena vacia.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>system_id</parameter></term>
<listitem>
<simpara>
Identificador de sistema de la declaración de notación externa.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>public_id</parameter></term>
<listitem>
<simpara>
Identificador público de la declaración de notación externa.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>notation_name</parameter></term>
<listitem>
<simpara>
Nombre de la notación de esta entidad (ver <function>xml_set_notation_decl_handler</function>).
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Si la función del manejador se configura como una cadena vacia, o &false;, el manejador en cuestión se deshabilita.
</para>
¬e.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
-->