2362N/A * Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 2362N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 2362N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2362N/A * or visit www.oracle.com if you need additional information or have any 0N/A * An AttributedString holds text and related attribute information. It 0N/A * may be used as the actual data storage in some cases where a text 0N/A * reader wants to access attributed text through the AttributedCharacterIterator 0N/A * An attribute is a key/value pair, identified by the key. No two 0N/A * attributes on a given character can have the same key. 0N/A * <p>The values for an attribute are immutable, or must not be mutated 0N/A * by clients or storage. They are always passed by reference, and not 0N/A * @see AttributedCharacterIterator 0N/A // since there are no vectors of int, we have to use arrays. 0N/A // We allocate them in chunks of 10 elements so we don't have to allocate all the time. 0N/A // field holding the text 0N/A // fields holding run attribute information 0N/A // run attributes are organized by run 0N/A int runCount;
// actual number of runs, <= runArraySize 0N/A * Constructs an AttributedString instance with the given 0N/A * AttributedCharacterIterators. 0N/A * @param iterators AttributedCharacterIterators to construct 0N/A * AttributedString from. 0N/A * @throws NullPointerException if iterators is null 0N/A // Build the String contents 0N/A // Determine the runs, creating a new run when the attributes 0N/A * Constructs an AttributedString instance with the given text. 0N/A * @param text The text for this attributed string. 0N/A * @exception NullPointerException if <code>text</code> is null. 0N/A * Constructs an AttributedString instance with the given text and attributes. 0N/A * @param text The text for this attributed string. 0N/A * @param attributes The attributes that apply to the entire string. 0N/A * @exception NullPointerException if <code>text</code> or 0N/A * <code>attributes</code> is null. 0N/A * @exception IllegalArgumentException if the text has length 0 0N/A * and the attributes parameter is not an empty Map (attributes 0N/A * cannot be applied to a 0-length range). 0N/A * Constructs an AttributedString instance with the given attributed 0N/A * text represented by AttributedCharacterIterator. 0N/A * @param text The text for this attributed string. 0N/A * @exception NullPointerException if <code>text</code> is null. 0N/A // If performance is critical, this constructor should be 0N/A // implemented here rather than invoking the constructor for a 0N/A // subrange. We can avoid some range checking in the loops. 0N/A * Constructs an AttributedString instance with the subrange of 0N/A * the given attributed text represented by 0N/A * AttributedCharacterIterator. If the given range produces an 0N/A * empty text, all attributes will be discarded. Note that any 0N/A * attributes wrapped by an Annotation object are discarded for a 0N/A * subrange of the original attribute range. 0N/A * @param text The text for this attributed string. 0N/A * @param beginIndex Index of the first character of the range. 0N/A * @param endIndex Index of the character following the last character 0N/A * @exception NullPointerException if <code>text</code> is null. 0N/A * @exception IllegalArgumentException if the subrange given by 0N/A * beginIndex and endIndex is out of the text range. 0N/A * @see java.text.Annotation 0N/A * Constructs an AttributedString instance with the subrange of 0N/A * the given attributed text represented by 0N/A * AttributedCharacterIterator. Only attributes that match the 0N/A * given attributes will be incorporated into the instance. If the 0N/A * given range produces an empty text, all attributes will be 0N/A * discarded. Note that any attributes wrapped by an Annotation 0N/A * object are discarded for a subrange of the original attribute 0N/A * @param text The text for this attributed string. 0N/A * @param beginIndex Index of the first character of the range. 0N/A * @param endIndex Index of the character following the last character 0N/A * @param attributes Specifies attributes to be extracted 0N/A * from the text. If null is specified, all available attributes will 0N/A * @exception NullPointerException if <code>text</code> is null. 0N/A * @exception IllegalArgumentException if the subrange given by 0N/A * beginIndex and endIndex is out of the text range. 0N/A * @see java.text.Annotation 0N/A // Validate the given subrange 0N/A // Copy the given string 0N/A // Select attribute keys to be taken care of 0N/A // Get and set attribute runs for each attribute name. Need to 0N/A // scan from the top of the text so that we can discard any 0N/A // Annotation that is no longer applied to a subset text segment. 0N/A // if the run is beyond the given (subset) range, we 0N/A // don't need to process further. 0N/A // attribute is applied to any subrange 0N/A * Adds an attribute to the entire string. 0N/A * @param attribute the attribute key 0N/A * @param value the value of the attribute; may be null 0N/A * @exception NullPointerException if <code>attribute</code> is null. 0N/A * @exception IllegalArgumentException if the AttributedString has length 0 0N/A * (attributes cannot be applied to a 0-length range). 0N/A * Adds an attribute to a subrange of the string. 0N/A * @param attribute the attribute key 0N/A * @param value The value of the attribute. May be null. 0N/A * @param beginIndex Index of the first character of the range. 0N/A * @param endIndex Index of the character following the last character of the range. 0N/A * @exception NullPointerException if <code>attribute</code> is null. 0N/A * @exception IllegalArgumentException if beginIndex is less then 0, endIndex is 0N/A * greater than the length of the string, or beginIndex and endIndex together don't 0N/A * define a non-empty subrange of the string. 0N/A * Adds a set of attributes to a subrange of the string. 0N/A * @param attributes The attributes to be added to the string. 0N/A * @param beginIndex Index of the first character of the range. 0N/A * @param endIndex Index of the character following the last 0N/A * character of the range. 0N/A * @exception NullPointerException if <code>attributes</code> is null. 0N/A * @exception IllegalArgumentException if beginIndex is less then 0N/A * 0, endIndex is greater than the length of the string, or 0N/A * beginIndex and endIndex together don't define a non-empty 0N/A * subrange of the string and the attributes parameter is not an 0N/A // make sure we have run attribute data vectors 0N/A // break up runs if necessary 0N/A // make sure we have run attribute data vectors 0N/A // break up runs if necessary 0N/A // use temporary variables so things remain consistent in case of an exception 0N/A runCount =
1;
// assume initial run starting at index 0 0N/A // ensure there's a run break at offset, return the index of the run 0N/A * Ensures there is a run break at offset, returning the index of 0N/A * the run. If this results in splitting a run, two things can happen: 0N/A * <li>If copyAttrs is true, the attributes from the existing run 0N/A * will be placed in both of the newly created runs. 0N/A * <li>If copyAttrs is false, the attributes from the existing run 0N/A * will NOT be copied to the run to the right (>= offset) of the break, 0N/A * but will exist on the run to the left (< offset). 0N/A // search for the run index where this offset should be 0N/A // if the offset is at a run start already, we're done 0N/A // we'll have to break up a run 0N/A // first, make sure we have enough space in our arrays 0N/A // make copies of the attribute information of the old run that the new one used to be part of 0N/A // use temporary variables so things remain consistent in case of an exception 0N/A // now actually break up the run 0N/A // add the attribute attribute/value to all runs where beginRunIndex <= runIndex < endRunIndex 0N/A int keyValueIndex = -
1;
// index of key and value in our vectors; assume we don't have an entry yet 0N/A // check whether we have an entry already 0N/A // update existing entry 0N/A * Creates an AttributedCharacterIterator instance that provides access to the entire contents of 0N/A * @return An iterator providing access to the text and its attributes. 0N/A * Creates an AttributedCharacterIterator instance that provides access to 0N/A * selected contents of this string. 0N/A * Information about attributes not listed in attributes that the 0N/A * implementor may have need not be made accessible through the iterator. 0N/A * If the list is null, all available attribute information should be made 0N/A * @param attributes a list of attributes that the client is interested in 0N/A * @return an iterator providing access to the entire text and its selected attributes 0N/A * Creates an AttributedCharacterIterator instance that provides access to 0N/A * selected contents of this string. 0N/A * Information about attributes not listed in attributes that the 0N/A * implementor may have need not be made accessible through the iterator. 0N/A * If the list is null, all available attribute information should be made 0N/A * @param attributes a list of attributes that the client is interested in 0N/A * @param beginIndex the index of the first character 0N/A * @param endIndex the index of the character following the last character 0N/A * @return an iterator providing access to the text and its attributes 0N/A * @exception IllegalArgumentException if beginIndex is less then 0, 0N/A * endIndex is greater than the length of the string, or beginIndex is 0N/A * greater than endIndex. 0N/A // all (with the exception of length) reading operations are private, 0N/A // since AttributedString instances are accessed through iterators. 0N/A // length is package private so that CharacterIteratorFieldDelegate can 0N/A // access it without creating an AttributedCharacterIterator. 0N/A // gets an attribute value, but returns an annotation only if it's range does not extend outside the range beginIndex..endIndex 0N/A // need to check whether the annotation's range extends outside the iterator's range 0N/A // annotation's range starts before iterator's range 0N/A // annotation's range ends after iterator's range 0N/A // annotation's range is subrange of iterator's range, 0N/A // so we can return the value 0N/A // returns whether all specified attributes have equal values in the runs with the given indices 0N/A // returns whether the two objects are either both null or equal 0N/A * Appends the contents of the CharacterIterator iterator into the 0N/A * Sets the attributes for the range from offset to the next run break 0N/A * (typically the end of the text) to the ones specified in attrs. 0N/A * This is only meant to be called from the constructor! 0N/A * Returns true if the attributes specified in last and attrs differ. 0N/A // the iterator class associated with this string class 0N/A // note on synchronization: 0N/A // we don't synchronize on the iterator, assuming that an iterator is only used in one thread. 0N/A // we do synchronize access to the AttributedString however, since it's more likely to be shared between threads. 0N/A // start and end index for our iteration 0N/A // attributes that our client is interested in 0N/A // the current index for our iteration 0N/A // invariant: beginIndex <= currentIndex <= endIndex 0N/A // information about the run that includes currentIndex 0N/A // Object methods. See documentation in that class. 0N/A // CharacterIterator methods. See documentation in that interface. 0N/A // AttributedCharacterIterator methods. See documentation in that interface. 0N/A // ??? would be nice to return null, but current spec doesn't allow it 0N/A // returning Hashtable saves AttributeMap from dealing with emptiness 0N/A // ??? This should screen out attribute keys that aren't relevant to the client 0N/A // ??? would be nice to return null, but current spec doesn't allow it 0N/A // returning HashSet saves us from dealing with emptiness 0N/A // ??? should try to create this only once, then update if necessary, 0N/A // and give callers read-only view 0N/A // internally used methods 0N/A // set the current index, update information about the current run if necessary, 0N/A // return the character at the current index 0N/A // update the information about the current run 0N/A // the map class associated with this string class, giving access to the attributes of one run