net.morimekta.util

Class Slice

java.lang.Object

net.morimekta.util.Slice

All Implemented Interfaces:

Comparable<Slice>, Stringable

Direct Known Subclasses:

JsonToken

public class Slice
extends Object
implements Comparable<Slice>, Stringable

A slice of a byte array. Note that all the helper methods assume UTF_8 encoding.

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	fb
protected int	len
protected int	off

Constructor Summary

Constructors

Constructor and Description
Slice(byte[] fb, int off, int len) Create a slice instance.

Method Summary

Modifier and Type	Method and Description
String	asString() Get the whole slice as a string.
char	charAt(int i) Get character at slice relative position.
int	compareTo(Slice o) Compare slice with other slice.
boolean	contains(byte a) Checks if a single byte can be found in the slice.
boolean	contains(byte[] a) Checks if the byte array is contained in the slice.
boolean	containsAny(byte... a) Checks if any of the provided bytes is contained in the slice.
boolean	equals(Object o)
int	hashCode()
int	length() Get the total length of the slice.
double	parseDouble() Get the whole slice as a real number.
long	parseInteger() Get the whole slice as a simple integer.
boolean	strEquals(byte[] a) Checks if the slice is equal to given byte array.
boolean	strEquals(byte[] a, int aOff, int aLen) Checks if the slice is equal to a portion of a given byte array.
Slice	substring(int start, int end) Create a substring slice based on the current slice.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

fb

protected final byte[] fb

off

protected final int off

len

protected final int len

Constructor Detail

Slice

public Slice(byte[] fb,
             int off,
             int len)

Create a slice instance. The slice is only meant to be internal state immutable, and not representing an immutable byte content.

Parameters:

fb - The buffer to wrap.

off - The start offset to wrap.

len - The length to represent.

Method Detail

length

public final int length()

Get the total length of the slice.

Returns:

The slice length.

asString

public final String asString()

Get the whole slice as a string.

Specified by:

asString in interface Stringable

Returns:

Slice decoded as UTF_8 string.

substring

public final Slice substring(int start,
                             int end)

Create a substring slice based on the current slice.

Parameters:

start - The internal start position, relative to the slice's offset.

end - The internal end position, relative to the slice's offset. If end is negative, then it is relative to the slice's end position.

Returns:

The substring slice.

charAt

public final char charAt(int i)

Get character at slice relative position.

Parameters:

i - The position to get. If negative is relative to the slice's end position.

Returns:

The char at given position.

parseInteger

public final long parseInteger()

Get the whole slice as a simple integer.

Returns:

Integer long value.

parseDouble

public final double parseDouble()

Get the whole slice as a real number.

Returns:

Real double value.

strEquals

public boolean strEquals(byte[] a)

Checks if the slice is equal to given byte array.

Parameters:

a - The array to compare with.

Returns:

True if equal.

strEquals

public boolean strEquals(byte[] a,
                         int aOff,
                         int aLen)

Checks if the slice is equal to a portion of a given byte array.

Parameters:

a - The array to compare with.

aOff - The offset to compare with in the array.

aLen - The length to compare with.

Returns:

True if equal.

containsAny

public boolean containsAny(byte... a)

Checks if any of the provided bytes is contained in the slice.

Parameters:

a - Bytes to find in the slice.

Returns:

True if any of the bytes were found.

contains

public boolean contains(byte[] a)

Checks if the byte array is contained in the slice.

Parameters:

a - The byte array to find.

Returns:

True if the byte array was found.

contains

public boolean contains(byte a)

Checks if a single byte can be found in the slice.

Parameters:

a - The byte to find.

Returns:

True of the byte was found.

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

compareTo

public int compareTo(Slice o)

Compare slice with other slice. Slice ordering: - Firstly ordered by start (offset) position. - Secondly ordered by reverse length (longest slice first). Result is undefined of the two slices point to different byte buffers.

Specified by:

compareTo in interface Comparable<Slice>

Parameters:

o - The other slice.

Returns:

Compared value.