Sophie

Sophie

distrib > Mandriva > 9.1 > ppc > media > main > by-pkgid > 0afeee9cca140e167a996902b9a677c5 > files > 2855

php-manual-en-4.3.0-2mdk.noarch.rpm

<HTML
><HEAD
><TITLE
>xml_set_processing_instruction_handler</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="PHP Manual"
HREF="index.html"><LINK
REL="UP"
TITLE="XML parser functions"
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=ISO-8859-1"></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"
>PHP Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.xml-set-object.html"
ACCESSKEY="P"
>Prev</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"
>Next</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="AEN96576"
></A
><P
>    (PHP 3&#62;= 3.0.6, PHP 4 )</P
>xml_set_processing_instruction_handler&nbsp;--&nbsp;
     Set up processing instruction (PI) handler
    </DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96579"
></A
><H2
>Description</H2
>bool <B
CLASS="methodname"
>xml_set_processing_instruction_handler</B
> ( resource parser, string handler)<BR
></BR
><P
>&#13;     Sets the processing instruction (PI) handler function for the XML parser
     <TT
CLASS="parameter"
><I
>parser</I
></TT
>.  <TT
CLASS="parameter"
><I
>handler</I
></TT
> 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
     <TT
CLASS="parameter"
><I
>parser</I
></TT
>.
    </P
><P
>&#13;     A processing instruction has the following format:
     <DIV
CLASS="informalexample"
><A
NAME="AEN96596"
></A
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="programlisting"
>&#60;?
       <TT
CLASS="replaceable"
><I
>target</I
></TT
> 
       <TT
CLASS="replaceable"
><I
>data</I
></TT
>?&#62;</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"
>?&#62;</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
>&#13;     The function named by <TT
CLASS="parameter"
><I
>handler</I
></TT
> 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
><TT
CLASS="parameter"
><I
>parser</I
></TT
></DT
><DD
><P
>&#13;         The first parameter, <TT
CLASS="replaceable"
><I
>parser</I
></TT
>, is a
         reference to the XML parser calling the handler.
        </P
></DD
><DT
><TT
CLASS="parameter"
><I
>target</I
></TT
></DT
><DD
><P
>&#13;         The second parameter, <TT
CLASS="parameter"
><I
>target</I
></TT
>, contains the PI
         target.
        </P
></DD
><DT
><TT
CLASS="parameter"
><I
>data</I
></TT
></DT
><DD
><P
>&#13;         The third parameter, <TT
CLASS="parameter"
><I
>data</I
></TT
>, contains the PI
         data.
        </P
></DD
></DL
></DIV
>
    </P
><P
>&#13;     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
>&#13;     <TT
CLASS="constant"
><B
>TRUE</B
></TT
> is returned if the handler is set up, <TT
CLASS="constant"
><B
>FALSE</B
></TT
> if
     <TT
CLASS="parameter"
><I
>parser</I
></TT
> is not a parser.
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Note: </B
>Instead of a function name, an
array containing an object reference and a method name can also be
supplied.</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"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.xml-set-start-namespace-decl-handler.html"
ACCESSKEY="N"
>Next</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"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>xml_set_start_namespace_decl_handler</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>