<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>xml_set_processing_instruction_handler</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="XML, Analisadores"
HREF="ref.xml.html"><LINK
REL="PREVIOUS"
TITLE="xml_set_object"
HREF="function.xml-set-object.html"><LINK
REL="NEXT"
TITLE="xml_set_start_namespace_decl_handler"
HREF="function.xml-set-start-namespace-decl-handler.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.xml-set-object.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.xml-set-start-namespace-decl-handler.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.xml-set-processing-instruction-handler"
></A
>xml_set_processing_instruction_handler</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN234895"
></A
><P
> (PHP 3 >= 3.0.6, PHP 4, PHP 5)</P
>xml_set_processing_instruction_handler --
Set up processing instruction (PI) handler
</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN234898"
></A
><H2
>Description</H2
>bool <B
CLASS="methodname"
>xml_set_processing_instruction_handler</B
> ( resource parser, callback handler )<BR
></BR
><P
> Sets the processing instruction (PI) handler function for the XML parser
<CODE
CLASS="parameter"
>parser</CODE
>.<CODE
CLASS="parameter"
>handler</CODE
> is a
string containing the name of a function that must exist when
<A
HREF="function.xml-parse.html"
><B
CLASS="function"
>xml_parse()</B
></A
> is called for
<CODE
CLASS="parameter"
>parser</CODE
>.
</P
><P
> A processing instruction has the following format:
<DIV
CLASS="informalexample"
><P
></P
><A
NAME="AEN234915"
></A
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="programlisting"
><?<TT
CLASS="replaceable"
><I
>target</I
></TT
>
<TT
CLASS="replaceable"
><I
>data</I
></TT
>?></PRE
></TD
></TR
></TABLE
><P
></P
></DIV
>
You can put PHP code into such a tag, but be aware of one limitation: in
an XML PI, the PI end tag (<TT
CLASS="literal"
>?></TT
>) can not be quoted,
so this character sequence should not appear in the PHP code you embed
with PIs in XML documents.If it does, the rest of the PHP code, as well
as the "real" PI end tag, will be treated as character data.
</P
><P
> The function named by <CODE
CLASS="parameter"
>handler</CODE
> must accept
three parameters:
<B
CLASS="methodname"
><TT
CLASS="replaceable"
><I
>handler</I
></TT
></B
> ( resource parser, string target, string data )<BR
></BR
>
<P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><CODE
CLASS="parameter"
>parser</CODE
></DT
><DD
><P
> The first parameter, <TT
CLASS="replaceable"
><I
>parser</I
></TT
>, is a
reference to the XML parser calling the handler.
</P
></DD
><DT
><CODE
CLASS="parameter"
>target</CODE
></DT
><DD
><P
> The second parameter, <CODE
CLASS="parameter"
>target</CODE
>, contains the PI
target.
</P
></DD
><DT
><CODE
CLASS="parameter"
>data</CODE
></DT
><DD
><P
> The third parameter, <CODE
CLASS="parameter"
>data</CODE
>, contains the PI
data.
</P
></DD
></DL
></DIV
>
</P
><P
> If a handler function is set to an empty string, or <TT
CLASS="constant"
><B
>FALSE</B
></TT
>, the handler
in question is disabled.
</P
><P
> <TT
CLASS="constant"
><B
>TRUE</B
></TT
> is returned if the handler is set up, <TT
CLASS="constant"
><B
>FALSE</B
></TT
> if
<CODE
CLASS="parameter"
>parser</CODE
> is not a parser.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>Ao invés de um nome de função, um
array contendo uma referência de objeto e ao nome de método também podem ser
fornecidos.</P
></BLOCKQUOTE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.xml-set-object.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.xml-set-start-namespace-decl-handler.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>xml_set_object</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.xml.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>xml_set_start_namespace_decl_handler</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
