1 /*
2  * Copyright (c) 2004 World Wide Web Consortium,
3  *
4  * (Massachusetts Institute of Technology, European Research Consortium for
5  * Informatics and Mathematics, Keio University). All Rights Reserved. This
6  * work is distributed under the W3C(r) Software License [1] in the hope that
7  * it will be useful, but WITHOUT ANY WARRANTY; without even the implied
8  * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
9  *
10  * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
11  */
12 
13 package org.w3c.dom;
14 
15 /**
16  * The <code>ProcessingInstruction</code> interface represents a "processing
17  * instruction", used in XML as a way to keep processor-specific information
18  * in the text of the document.
19  * <p> No lexical check is done on the content of a processing instruction and
20  * it is therefore possible to have the character sequence
21  * <code>"?&gt;"</code> in the content, which is illegal a processing
22  * instruction per section 2.6 of [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. The
23  * presence of this character sequence must generate a fatal error during
24  * serialization.
25  * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
26  */
27 public interface ProcessingInstruction extends Node {
28     /**
29      * The target of this processing instruction. XML defines this as being
30      * the first token following the markup that begins the processing
31      * instruction.
32      */
getTarget()33     public String getTarget();
34 
35     /**
36      * The content of this processing instruction. This is from the first non
37      * white space character after the target to the character immediately
38      * preceding the <code>?&gt;</code>.
39      */
getData()40     public String getData();
41     /**
42      * The content of this processing instruction. This is from the first non
43      * white space character after the target to the character immediately
44      * preceding the <code>?&gt;</code>.
45      * @exception DOMException
46      *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
47      */
setData(String data)48     public void setData(String data)
49                                    throws DOMException;
50 
51 }
52