From 554fd8c5195424bdbcabf5de30fdc183aba391bd Mon Sep 17 00:00:00 2001 From: upstream source tree Date: Sun, 15 Mar 2015 20:14:05 -0400 Subject: obtained gcc-4.6.4.tar.bz2 from upstream website; verified gcc-4.6.4.tar.bz2.sig; imported gcc-4.6.4 source tree from verified upstream tarball. downloading a git-generated archive based on the 'upstream' tag should provide you with a source tree that is binary identical to the one extracted from the above tarball. if you have obtained the source via the command 'git clone', however, do note that line-endings of files in your working directory might differ from line-endings of the respective files in the upstream repository. --- .../external/w3c_dom/org/w3c/dom/Text.java | 126 +++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java (limited to 'libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java') diff --git a/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java b/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java new file mode 100644 index 000000000..872c5499d --- /dev/null +++ b/libjava/classpath/external/w3c_dom/org/w3c/dom/Text.java @@ -0,0 +1,126 @@ +/* + * Copyright (c) 2004 World Wide Web Consortium, + * + * (Massachusetts Institute of Technology, European Research Consortium for + * Informatics and Mathematics, Keio University). All Rights Reserved. This + * work is distributed under the W3C(r) Software License [1] in the hope that + * it will be useful, but WITHOUT ANY WARRANTY; without even the implied + * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + * + * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231 + */ + +package org.w3c.dom; + +/** + * The Text interface inherits from CharacterData + * and represents the textual content (termed character data in XML) of an Element or Attr. If there is no + * markup inside an element's content, the text is contained in a single + * object implementing the Text interface that is the only + * child of the element. If there is markup, it is parsed into the + * information items (elements, comments, etc.) and Text nodes + * that form the list of children of the element. + *

When a document is first made available via the DOM, there is only one + * Text node for each block of text. Users may create adjacent + * Text nodes that represent the contents of a given element + * without any intervening markup, but should be aware that there is no way + * to represent the separations between these nodes in XML or HTML, so they + * will not (in general) persist between DOM editing sessions. The + * Node.normalize() method merges any such adjacent + * Text objects into a single node for each block of text. + *

No lexical check is done on the content of a Text node + * and, depending on its position in the document, some characters must be + * escaped during serialization using character references; e.g. the + * characters "<&" if the textual content is part of an element or of + * an attribute, the character sequence "]]>" when part of an element, + * the quotation mark character " or the apostrophe character ' when part of + * an attribute. + *

See also the Document Object Model (DOM) Level 3 Core Specification. + */ +public interface Text extends CharacterData { + /** + * Breaks this node into two nodes at the specified offset, + * keeping both in the tree as siblings. After being split, this node + * will contain all the content up to the offset point. A + * new node of the same type, which contains all the content at and + * after the offset point, is returned. If the original + * node had a parent node, the new node is inserted as the next sibling + * of the original node. When the offset is equal to the + * length of this node, the new node has no data. + * @param offset The 16-bit unit offset at which to split, starting from + * 0. + * @return The new node, of the same type as this node. + * @exception DOMException + * INDEX_SIZE_ERR: Raised if the specified offset is negative or greater + * than the number of 16-bit units in data. + *
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. + */ + public Text splitText(int offset) + throws DOMException; + + /** + * Returns whether this text node contains + * element content whitespace, often abusively called "ignorable whitespace". The text node is + * determined to contain whitespace in element content during the load + * of the document or if validation occurs while using + * Document.normalizeDocument(). + * @since DOM Level 3 + */ + public boolean isElementContentWhitespace(); + + /** + * Returns all text of Text nodes logically-adjacent text + * nodes to this node, concatenated in document order. + *
For instance, in the example below wholeText on the + * Text node that contains "bar" returns "barfoo", while on + * the Text node that contains "foo" it returns "barfoo". + * @since DOM Level 3 + */ + public String getWholeText(); + + /** + * Replaces the text of the current node and all logically-adjacent text + * nodes with the specified text. All logically-adjacent text nodes are + * removed including the current node unless it was the recipient of the + * replacement text. + *
This method returns the node which received the replacement text. + * The returned node is: + *

+ *
For instance, in the above example calling + * replaceWholeText on the Text node that + * contains "bar" with "yo" in argument results in the following: + *
Where the nodes to be removed are read-only descendants of an + * EntityReference, the EntityReference must + * be removed instead of the read-only nodes. If any + * EntityReference to be removed has descendants that are + * not EntityReference, Text, or + * CDATASection nodes, the replaceWholeText + * method must fail before performing any modification of the document, + * raising a DOMException with the code + * NO_MODIFICATION_ALLOWED_ERR. + *
For instance, in the example below calling + * replaceWholeText on the Text node that + * contains "bar" fails, because the EntityReference node + * "ent" contains an Element node which cannot be removed. + * @param content The content of the replacing Text node. + * @return The Text node created with the specified content. + * @exception DOMException + * NO_MODIFICATION_ALLOWED_ERR: Raised if one of the Text + * nodes being replaced is readonly. + * @since DOM Level 3 + */ + public Text replaceWholeText(String content) + throws DOMException; + +} -- cgit v1.2.3