com.grey.base.utils

Class ByteChars

java.lang.Object

com.grey.base.utils.ArrayRef<byte[]>

com.grey.base.utils.ByteArrayRef

com.grey.base.utils.ByteChars

All Implemented Interfaces:

CharSequence, Comparable<ByteChars>

public final class ByteChars
extends ByteArrayRef
implements CharSequence, Comparable<ByteChars>

This class is a byte array handle which lets us handle the byte array as if it were composed of single-byte chars (effectively 8-bit text) - and conversely also lets us treat 8-bit text as a byte array. All without doing any charset conversions.
That assumption holds true for a wide range of Internet protocols (HTTP headers, FTP commands, SMTP, etc), so this class lets us operate on the raw byte-stream protocol data as if it was a string, without having to copy or transform it.

Nested Class Summary

Nested classes/interfaces inherited from class com.grey.base.utils.ArrayRef

ArrayRef.Allocator<T>

Constructor Summary

Constructors

Constructor and Description
ByteChars()
ByteChars(byte[] src)
ByteChars(byte[] src, boolean copy)
ByteChars(byte[] src, int off, int len, boolean copy)
ByteChars(ByteArrayRef src, boolean copy)
ByteChars(CharSequence src)
ByteChars(CharSequence src, int off, int len)
ByteChars(int cap)

Method Summary

Modifier and Type	Method and Description
ByteChars	append(byte[] src)
ByteChars	append(byte[] barr, int off, int len)
ByteChars	append(char[] src)
ByteChars	append(char[] carr, int off, int len)
ByteChars	append(CharSequence str)
ByteChars	append(CharSequence cs, int csoff, int cslen)
ByteChars	append(int bval)
ByteChars	append(long numval, StringBuilder strbuf)
char	charAt(int idx)
ByteChars	clear()
int	compareTo(ByteChars bc2)
static ByteChars	convertCharSequence(CharSequence src, ByteChars buf)
ByteChars	digest(MessageDigest digestproc)
boolean	endsWith(CharSequence cs)
boolean	endsWith(CharSequence cs, int csoff, int cslen)
boolean	equalsChars(char[] arr)
boolean	equalsChars(char[] carr, int coff, int clen)
boolean	equalsIgnoreCase(CharSequence str)
ByteChars	extractTerm(byte dlm, int off, int target, boolean to_end, ByteChars ptr) Breaks up the current buffer into a sequence of terms, and returns the specified term.
int	indexOf(byte[] seq)
int	indexOf(CharSequence cs)
int	indexOf(int val)
int	indexOf(int off, byte[] seq, int soff, int slen)
int	indexOf(int bcoff, CharSequence cs)
int	indexOf(int bcoff, CharSequence cs, int csoff, int cslen)
int	indexOf(int off, int val)
int	lastIndexOf(int val)
int	lastIndexOf(int off, int val)
int	length()
long	parseDecimal()
long	parseDecimal(int off, int len)
long	parseHexadecimal()
long	parseHexadecimal(int off, int len)
static ArrayList<ByteChars>	parseTerms(byte[] barr, int off, int len, byte dlm, ArrayList<ByteChars> terms, ObjectWell<ByteChars> store)
static ArrayList<ByteChars>	parseTerms(CharSequence str, int off, int len, byte dlm, ArrayList<ByteChars> terms, ObjectWell<ByteChars> store, ByteChars bctmp)
ByteChars	populate(byte[] src)
ByteChars	populate(byte[] src, int off, int len)
ByteChars	populate(CharSequence src)
ByteChars	populate(CharSequence src, int off, int len)
ByteChars	populateBytes(ByteArrayRef src)
ByteChars	set(byte[] src)
ByteChars	set(byte[] src, int off, int len)
ByteChars	set(ByteArrayRef src)
ByteChars	set(ByteArrayRef src, int off)
ByteChars	set(ByteArrayRef src, int off, int len)
boolean	startsWith(CharSequence cs)
boolean	startsWith(CharSequence cs, int csoff, int cslen)
CharSequence	subSequence(int start, int end)
char[]	toCharArray()
char[]	toCharArray(int off, int len, char[] chbuf)
ByteChars	toLowerCase()
String	toString()
String	toString(int off, int len)
ByteChars	toUpperCase()

Methods inherited from class com.grey.base.utils.ByteArrayRef

allocBuffer, arraySize, byteAt, canEqual, count, count, count, count, equals, equalsBytes, equalsBytes, hashCode, setByte, totalBufferSize

Methods inherited from class com.grey.base.utils.ArrayRef

advance, buffer, capacity, copy, copyIn, copyIn, copyOut, copyOut, ensureCapacity, ensureSpareCapacity, getBuffer, getOffset, getOffset, getSize, incrementSize, limit, offset, offset, set, set, set, setSize, size, spareCapacity, toArray, toArray, toArray, toArray, totalBufferSize

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Constructor Detail

ByteChars

public ByteChars()

ByteChars

public ByteChars(int cap)

ByteChars

public ByteChars(byte[] src)

ByteChars

public ByteChars(byte[] src,
                 boolean copy)

ByteChars

public ByteChars(byte[] src,
                 int off,
                 int len,
                 boolean copy)

ByteChars

public ByteChars(CharSequence src)

ByteChars

public ByteChars(ByteArrayRef src,
                 boolean copy)

ByteChars

public ByteChars(CharSequence src,
                 int off,
                 int len)

Method Detail

populate

public ByteChars populate(byte[] src)

populate

public ByteChars populate(byte[] src,
                          int off,
                          int len)

populate

public ByteChars populate(CharSequence src)

populate

public ByteChars populate(CharSequence src,
                          int off,
                          int len)

populateBytes

public ByteChars populateBytes(ByteArrayRef src)

append

public ByteChars append(byte[] src)

append

public ByteChars append(char[] src)

set

public ByteChars set(ByteArrayRef src)

set

public ByteChars set(ByteArrayRef src,
                     int off)

set

public ByteChars set(ByteArrayRef src,
                     int off,
                     int len)

indexOf

public int indexOf(CharSequence cs)

indexOf

public int indexOf(int bcoff,
                   CharSequence cs)

indexOf

public int indexOf(int val)

indexOf

public int indexOf(byte[] seq)

lastIndexOf

public int lastIndexOf(int val)

startsWith

public boolean startsWith(CharSequence cs)

endsWith

public boolean endsWith(CharSequence cs)

equalsChars

public boolean equalsChars(char[] arr)

toCharArray

public char[] toCharArray()

parseDecimal

public long parseDecimal()

parseDecimal

public long parseDecimal(int off,
                         int len)

parseHexadecimal

public long parseHexadecimal()

parseHexadecimal

public long parseHexadecimal(int off,
                             int len)

length

public int length()

Specified by:

length in interface CharSequence

charAt

public char charAt(int idx)

Specified by:

charAt in interface CharSequence

clear

public ByteChars clear()

Overrides:

clear in class ArrayRef<byte[]>

set

public ByteChars set(byte[] src,
                     int off,
                     int len)

Overrides:

set in class ArrayRef<byte[]>

set

public ByteChars set(byte[] src)

Overrides:

set in class ArrayRef<byte[]>

append

public ByteChars append(byte[] barr,
                        int off,
                        int len)

append

public ByteChars append(char[] carr,
                        int off,
                        int len)

append

public ByteChars append(int bval)

append

public ByteChars append(long numval,
                        StringBuilder strbuf)

append

public ByteChars append(CharSequence str)

append

public ByteChars append(CharSequence cs,
                        int csoff,
                        int cslen)

indexOf

public int indexOf(int off,
                   int val)

indexOf

public int indexOf(int off,
                   byte[] seq,
                   int soff,
                   int slen)

lastIndexOf

public int lastIndexOf(int off,
                       int val)

indexOf

public int indexOf(int bcoff,
                   CharSequence cs,
                   int csoff,
                   int cslen)

startsWith

public boolean startsWith(CharSequence cs,
                          int csoff,
                          int cslen)

endsWith

public boolean endsWith(CharSequence cs,
                        int csoff,
                        int cslen)

equalsChars

public boolean equalsChars(char[] carr,
                           int coff,
                           int clen)

equalsIgnoreCase

public boolean equalsIgnoreCase(CharSequence str)

compareTo

public int compareTo(ByteChars bc2)

Specified by:

compareTo in interface Comparable<ByteChars>

toString

public String toString()

Specified by:

toString in interface CharSequence

Overrides:

toString in class ArrayRef<byte[]>

toString

public String toString(int off,
                       int len)

subSequence

public CharSequence subSequence(int start,
                                int end)

Specified by:

subSequence in interface CharSequence

toCharArray

public char[] toCharArray(int off,
                          int len,
                          char[] chbuf)

toLowerCase

public ByteChars toLowerCase()

toUpperCase

public ByteChars toUpperCase()

extractTerm

public ByteChars extractTerm(byte dlm,
                             int off,
                             int target,
                             boolean to_end,
                             ByteChars ptr)

Breaks up the current buffer into a sequence of terms, and returns the specified term. The dlm parameter breaks up the current buffer into a sequence of terms, where the first term has id=0, the second id=1, etc

Parameters:

dlm - Delimits the terms, where the first term has id=0, the second id=1, etc

off - Start processing buffer at this offset - positions 0 to off-1 are ignored.

target - Specifies which term to return, where the first term is 0, the second is 1, etc

to_end - If True, the rest of this buffer from the specified term onwards is returned, unbroken by 'dlm'

ptr - If null, this method allocates a new lightweight ByteChars to use as the return value, but if an existing ByteChars object is passed in here, it is used to point at the returned term, without having to allocate a new Object.

Returns:

Another ByteChars ref pointing at the specified term

digest

public ByteChars digest(MessageDigest digestproc)

convertCharSequence

public static ByteChars convertCharSequence(CharSequence src,
                                            ByteChars buf)

parseTerms

public static ArrayList<ByteChars> parseTerms(byte[] barr,
                                              int off,
                                              int len,
                                              byte dlm,
                                              ArrayList<ByteChars> terms,
                                              ObjectWell<ByteChars> store)

parseTerms

public static ArrayList<ByteChars> parseTerms(CharSequence str,
                                              int off,
                                              int len,
                                              byte dlm,
                                              ArrayList<ByteChars> terms,
                                              ObjectWell<ByteChars> store,
                                              ByteChars bctmp)