net.sf.extjwnl.util

Class ByteArrayCharSequence

java.lang.Object

net.sf.extjwnl.util.ByteArrayCharSequence

All Implemented Interfaces:

java.lang.CharSequence, PointedCharSequence

public class ByteArrayCharSequence
extends java.lang.Object
implements PointedCharSequence

CharSequence backed by byte array. Does not convert encoding. Does not check bounds.

Constructor Summary

Constructors

Constructor and Description
ByteArrayCharSequence(byte[] bytes, int start, int end) Creates a char sequence backed by bytes, starting from start (inclusive) and ending at end (exclusive).
ByteArrayCharSequence(byte[] bytes, int start, int end, long position) Creates a char sequence backed by bytes, starting from start (inclusive) and ending at end (exclusive).

Method Summary

Modifier and Type	Method and Description
char	charAt(int index)
int	compareTo(java.lang.String anotherString) Compares the sequence and the string lexicographically.
long	getLastBytePosition() Position of the last byte of this sequence in the file (exclusive).
int	indexOf(java.lang.String str) Returns the index within this sequence of the first occurrence of the specified substring.
int	length()
java.lang.CharSequence	subSequence(int start, int end)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Constructor Detail

ByteArrayCharSequence

public ByteArrayCharSequence(byte[] bytes,
                             int start,
                             int end)

Creates a char sequence backed by bytes, starting from start (inclusive) and ending at end (exclusive).

Parameters:

bytes - backing byte array

start - start index (inclusive)

end - end index (exclusive)

ByteArrayCharSequence

public ByteArrayCharSequence(byte[] bytes,
                             int start,
                             int end,
                             long position)

Creates a char sequence backed by bytes, starting from start (inclusive) and ending at end (exclusive).

Parameters:

bytes - backing byte array

start - start index (inclusive)

end - end index (exclusive)

position - last byte position (exclusive)

Method Detail

getLastBytePosition

public long getLastBytePosition()

Description copied from interface: PointedCharSequence

Position of the last byte of this sequence in the file (exclusive).

Specified by:

getLastBytePosition in interface PointedCharSequence

Returns:

position of the last byte of this sequence in the file (exclusive)

length

public int length()

Specified by:

length in interface java.lang.CharSequence

charAt

public char charAt(int index)

Specified by:

charAt in interface java.lang.CharSequence

subSequence

public java.lang.CharSequence subSequence(int start,
                                          int end)

Specified by:

subSequence in interface java.lang.CharSequence

toString

public java.lang.String toString()

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object

indexOf

public int indexOf(java.lang.String str)

Description copied from interface: PointedCharSequence

Returns the index within this sequence of the first occurrence of the specified substring.

The returned index is the smallest value k for which:

 this.startsWith(str, k)
 

If no such value of k exists, then -1 is returned.

Specified by:

indexOf in interface PointedCharSequence

Parameters:

str - the substring to search for.

Returns:

the index of the first occurrence of the specified substring, or -1 if there is no such occurrence.

compareTo

public int compareTo(java.lang.String anotherString)

Description copied from interface: PointedCharSequence

Compares the sequence and the string lexicographically. The comparison is based on the Unicode value of each character in the strings. The character sequence represented by this object is compared lexicographically to the character sequence represented by the argument string. The result is a negative integer if this object lexicographically precedes the argument string. The result is a positive integer if this object lexicographically follows the argument string. The result is zero if the strings are equal; compareTo returns 0 exactly when the equals(Object) method would return true.

This is the definition of lexicographic ordering. If two strings are different, then either they have different characters at some index that is a valid index for both strings, or their lengths are different, or both. If they have different characters at one or more index positions, let k be the smallest such index; then the string whose character at position k has the smaller value, as determined by using the < operator, lexicographically precedes the other string. In this case, compareTo returns the difference of the two character values at position k in the two string -- that is, the value:

 this.charAt(k)-anotherString.charAt(k)
 

If there is no index position at which they differ, then the shorter string lexicographically precedes the longer string. In this case, compareTo returns the difference of the lengths of the strings -- that is, the value:

 this.length()-anotherString.length()
 

Specified by:

compareTo in interface PointedCharSequence

Parameters:

anotherString - the String to be compared.

Returns:

the value 0 if the argument string is equal to this string; a value less than 0 if this string is lexicographically less than the string argument; and a value greater than 0 if this string is lexicographically greater than the string argument.