water.parser

Class BufferedString

java.lang.Object

water.Iced

water.parser.BufferedString

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<BufferedString>, Freezable

public class BufferedString
extends Iced
implements java.lang.Comparable<BufferedString>

A mutable wrapper to hold String as a byte array. It can be modified by set of methods, the hash code is computed on the fly. There is no speed up benefit of cashing the hash in a dedicated private field. See the speed test in ParseTest2#testSpeedOfCategoricalUpdate. Warning: This data structure is not designed for parallel access!

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	_buf
protected int	_len
protected int	_off
static byte	INT
static byte	NA
static byte	REAL

Constructor Summary

Constructors

Constructor and Description
BufferedString()
BufferedString(byte[] buf, int off, int len)
BufferedString(java.lang.String from)

Method Summary

Modifier and Type	Method and Description
int	compareTo(BufferedString o) Comparison, according to Comparable interface
boolean	equals(java.lang.Object o)
boolean	equalsAsciiString(java.lang.String str) Tests whether this BufferedString is equal to a given ASCII string
byte[]	getBuffer()
byte	getNumericType()
int	getOffset()
int	hashCode()
int	length()
BufferedString	read_impl(AutoBuffer ab)
BufferedString	set(byte[] buf)
BufferedString	set(byte[] buf, int off, int len)
BufferedString	set(java.lang.String s)
void	setLen(int len)
void	setOff(int off)
static BufferedString[]	toBufferedString(java.lang.String[] strings)
java.lang.String	toSanitizedString() Converts this BufferedString into an ASCII String where all original non-ASCII characters are represented in a hexadecimal notation.
java.lang.String	toString()
static java.lang.String[]	toString(BufferedString[] bStr)
AutoBuffer	write_impl(AutoBuffer ab)

Methods inherited from class water.Iced

asBytes, clone, copyOver, frozenType, read, readExternal, readJSON, reloadFromBytes, toJsonBytes, toJsonString, write, writeExternal, writeJSON

Methods inherited from class java.lang.Object

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

Field Detail

_buf

protected byte[] _buf

_off

protected int _off

_len

protected int _len

NA

public static final byte NA

See Also:

Constant Field Values

INT

public static final byte INT

See Also:

Constant Field Values

REAL

public static final byte REAL

See Also:

Constant Field Values

Constructor Detail

BufferedString

public BufferedString(byte[] buf,
                      int off,
                      int len)

BufferedString

public BufferedString(java.lang.String from)

BufferedString

public BufferedString()

Method Detail

write_impl

public final AutoBuffer write_impl(AutoBuffer ab)

read_impl

public final BufferedString read_impl(AutoBuffer ab)

compareTo

public int compareTo(BufferedString o)

Comparison, according to Comparable interface

Specified by:

compareTo in interface java.lang.Comparable<BufferedString>

Parameters:

o - other string to compare

Returns:

-1 or 0 or 1, as specified in Comparable

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toSanitizedString

public java.lang.String toSanitizedString()

Converts this BufferedString into an ASCII String where all original non-ASCII characters are represented in a hexadecimal notation.

Returns:

Sanitized String value (safe to use eg. in domains).

toString

public static java.lang.String[] toString(BufferedString[] bStr)

toBufferedString

public static BufferedString[] toBufferedString(java.lang.String[] strings)

set

public final BufferedString set(byte[] buf)

set

public BufferedString set(byte[] buf,
                          int off,
                          int len)

set

public final BufferedString set(java.lang.String s)

setOff

public void setOff(int off)

setLen

public void setLen(int len)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

equalsAsciiString

public boolean equalsAsciiString(java.lang.String str)

Tests whether this BufferedString is equal to a given ASCII string

Parameters:

str - string sequence made of ASCII characters (0..127)

Returns:

true if this BufferedString represents a given ASCII String, false if sequences differ or if the test string is not actually made of just ASCII characters

getBuffer

public final byte[] getBuffer()

getOffset

public final int getOffset()

length

public final int length()

getNumericType

public final byte getNumericType()