public Class ReplaceableUCharacterIterator

Public constructor

Parameters

str:String

text which the iterator will be based on

Public constructor

Parameters

buf:StringBuffer

buffer of text on which the iterator will be based

Overrides jdk.internal.icu.text.UCharacterIterator.clone.

Creates a copy of this iterator, does not clone the underlying Replaceableobject

Returns:ReplaceableUCharacterIterator

copy of this iterator

Returns the current UTF16 character.

Returns:int

current UTF16 character

Implements abstract jdk.internal.icu.text.UCharacterIterator.getIndex.

Gets the current currentIndex in text.

Returns:int

current currentIndex in text.

Implements abstract jdk.internal.icu.text.UCharacterIterator.getLength.

Returns the length of the text

Returns:int

length of the text

Implements abstract jdk.internal.icu.text.UCharacterIterator.getText.

Doc from jdk.internal.icu.text.UCharacterIterator.getText.

Fills the buffer with the underlying text storage of the iterator If the buffer capacity is not enough a exception is thrown. The capacity of the fill in buffer should at least be equal to length of text in the iterator obtained by calling getLength(). Usage:

UChacterIterator iter = new UCharacterIterator.getInstance(text);
        char[] buf = new char[iter.getLength()];
        iter.getText(buf);

        OR
        char[] buf= new char[1];
        int len = 0;
        for(;;){
            try{
                len = iter.getText(buf);
                break;
            }catch(IndexOutOfBoundsException e){
                buf = new char[iter.getLength()];
            }
        }

Implements abstract jdk.internal.icu.text.UCharacterIterator.next.

Returns next UTF16 character and increments the iterator's currentIndex by 1. If the resulting currentIndex is greater or equal to the text length, the currentIndex is reset to the text length and a value of DONECODEPOINT is returned.

Returns:int

next UTF16 character in text or DONE if the new currentIndex is off the end of the text range.

Implements abstract jdk.internal.icu.text.UCharacterIterator.previous.

Returns previous UTF16 character and decrements the iterator's currentIndex by 1. If the resulting currentIndex is less than 0, the currentIndex is reset to 0 and a value of DONECODEPOINT is returned.

Returns:int

next UTF16 character in text or DONE if the new currentIndex is off the start of the text range.

Implements abstract jdk.internal.icu.text.UCharacterIterator.setIndex.

Sets the currentIndex to the specified currentIndex in the text and returns that single UTF16 character at currentIndex. This assumes the text is stored as 16-bit code units.

Parameters

currentIndex:int

the currentIndex within the text.

Exceptions

IllegalArgumentException:

is thrown if an invalid currentIndex is supplied. i.e. currentIndex is out of bounds.