diff NGSrich_0.5.5/src/org/jdom/input/TextBuffer.java @ 0:89ad0a9cca52 default tip

Uploaded

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/NGSrich_0.5.5/src/org/jdom/input/TextBuffer.java	Mon Nov 21 08:12:19 2011 -0500
@@ -0,0 +1,186 @@
+/*--
+
+ $Id: TextBuffer.java,v 1.10 2007/11/10 05:29:00 jhunter Exp $
+
+ Copyright (C) 2000-2007 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions, and the disclaimer that follows
+    these conditions in the documentation and/or other materials
+    provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+    derived from this software without prior written permission.  For
+    written permission, please contact <request_AT_jdom_DOT_org>.
+
+ 4. Products derived from this software may not be called "JDOM", nor
+    may "JDOM" appear in their name, without prior written permission
+    from the JDOM Project Management <request_AT_jdom_DOT_org>.
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+     "This product includes software developed by the
+      JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED.  IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
+ Brett McLaughlin <brett_AT_jdom_DOT_org>.  For more information
+ on the JDOM Project, please see <http://www.jdom.org/>.
+
+ */
+
+package org.jdom.input;
+
+import org.jdom.*;
+
+/**
+ * A non-public utility class similar to StringBuffer but optimized for XML
+ * parsing where the common case is that you get only one chunk of characters
+ * per text section. TextBuffer stores the first chunk of characters in a
+ * String, which can just be returned directly if no second chunk is received.
+ * Subsequent chunks are stored in a supplemental char array (like StringBuffer
+ * uses). In this case, the returned text will be the first String chunk,
+ * concatenated with the subsequent chunks stored in the char array. This
+ * provides optimal performance in the common case, while still providing very
+ * good performance in the uncommon case. Furthermore, avoiding StringBuffer
+ * means that no extra unused char array space will be kept around after parsing
+ * is through.
+ *
+ * @version $Revision: 1.10 $, $Date: 2007/11/10 05:29:00 $
+ * @author  Bradley S. Huffman
+ * @author  Alex Rosen
+ */
+class TextBuffer {
+
+    private static final String CVS_ID =
+    "@(#) $RCSfile: TextBuffer.java,v $ $Revision: 1.10 $ $Date: 2007/11/10 05:29:00 $ $Name: jdom_1_1_1 $";
+
+    /** The first part of the text value (the "prefix"). If null, the
+      * text value is the empty string. */
+    private String prefixString;
+
+    /** The rest of the text value (the "suffix"). Only the first 
+      * code>arraySize</code> characters are valid. */
+    private char[] array;
+
+    /** The size of the rest of the text value. If zero, then only 
+      * code>prefixString</code> contains the text value. */
+    private int arraySize;
+
+    /** Constructor */
+    TextBuffer() {
+        array = new char[4096]; // initial capacity
+        arraySize = 0;
+    }
+
+    /** Append the specified text to the text value of this buffer. */
+    void append(char[] source, int start, int count) {
+        if (prefixString == null) {
+            // This is the first chunk, so we'll store it in the prefix string
+            prefixString = new String(source, start, count);
+        }
+        else {
+            // This is a subsequent chunk, so we'll add it to the char array
+            ensureCapacity(arraySize + count);
+            System.arraycopy(source, start, array, arraySize, count);
+            arraySize += count;
+        }
+    }
+
+    /** Returns the size of the text value. */
+    int size() {
+        if (prefixString == null) {
+            return 0;
+        }
+        else {
+            return prefixString.length() + arraySize;
+        }
+    }
+
+    /** Clears the text value and prepares the TextBuffer for reuse. */
+    void clear() {
+        arraySize = 0;
+        prefixString = null;
+    }
+
+    boolean isAllWhitespace() {
+        if ((prefixString == null) || (prefixString.length() == 0)) {
+            return true;
+        }
+
+        int size = prefixString.length();
+        for(int i = 0; i < size; i++) {
+            if ( !Verifier.isXMLWhitespace(prefixString.charAt(i))) {
+                return false;
+            }
+        }
+
+        for(int i = 0; i < arraySize; i++) {
+            if ( !Verifier.isXMLWhitespace(array[i])) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /** Returns the text value stored in the buffer. */
+    public String toString() {
+        if (prefixString == null) {
+            return "";
+        }
+
+        String str = "";
+        if (arraySize == 0) {
+            // Char array is empty, so the text value is just prefixString.
+            str = prefixString;
+        }
+        else {
+            // Char array is not empty, so the text value is prefixString
+            // plus the char array.
+            str = new StringBuffer(prefixString.length() + arraySize)
+                    .append(prefixString)
+                    .append(array, 0, arraySize)
+                    .toString();
+        }
+        return str;
+    }
+
+    // Ensure that the char array has room for at least "csize" characters.
+    private void ensureCapacity(int csize) {
+        int capacity = array.length;
+        if (csize > capacity) {
+            char[] old = array;
+            int nsize = capacity;
+            while (csize > nsize) {
+                nsize += (capacity/2);
+            }
+            array = new char[nsize];
+            System.arraycopy(old, 0, array, 0, arraySize);
+        }
+    }
+}