Class ValueNull

java.lang.Object

org.h2.value.VersionedValue<Value>

org.h2.value.Value

org.h2.value.ValueNull

All Implemented Interfaces:

HasSQL, Typed

public final class ValueNull
extends Value

Implementation of NULL. NULL is not a regular data type.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final int	DISPLAY_SIZE	The display size of the textual representation of NULL.
static final ValueNull	INSTANCE	The main NULL instance.
(package private) static final int	PRECISION	The precision of NULL.

Fields inherited from class Value

ARRAY, ASSIGN_TO, BIGINT, BINARY, BLOB, BOOLEAN, CAST_TO, CHAR, CLOB, CONVERT_TO, DATE, DECFLOAT, DOUBLE, EMPTY_VALUES, ENUM, GEOMETRY, GROUP_BINARY_STRING, GROUP_BOOLEAN, GROUP_CHARACTER_STRING, GROUP_COLLECTION, GROUP_DATETIME, GROUP_INTERVAL_DT, GROUP_INTERVAL_YM, GROUP_NULL, GROUP_NUMERIC, GROUP_OTHER, GROUPS, INTEGER, INTERVAL_DAY, INTERVAL_DAY_TO_HOUR, INTERVAL_DAY_TO_MINUTE, INTERVAL_DAY_TO_SECOND, INTERVAL_HOUR, INTERVAL_HOUR_TO_MINUTE, INTERVAL_HOUR_TO_SECOND, INTERVAL_MINUTE, INTERVAL_MINUTE_TO_SECOND, INTERVAL_MONTH, INTERVAL_SECOND, INTERVAL_YEAR, INTERVAL_YEAR_TO_MONTH, JAVA_OBJECT, JSON, MAX_LONG_DECIMAL, MIN_LONG_DECIMAL, NULL, NUMERIC, REAL, ROW, SMALLINT, TIME, TIME_TZ, TIMESTAMP, TIMESTAMP_TZ, TINYINT, TYPE_COUNT, UNKNOWN, UUID, VARBINARY, VARCHAR, VARCHAR_IGNORECASE

Fields inherited from interface HasSQL

ADD_PLAN_INFORMATION, DEFAULT_SQL_FLAGS, NO_CASTS, QUOTE_ONLY_WHEN_REQUIRED, REPLACE_LOBS_FOR_TRACE, TRACE_SQL_FLAGS

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ValueNull()

Method Summary

Modifier and Type	Method	Description
int	compareTypeSafe(Value v, CompareMode mode, CastDataProvider provider)	Compare this value against another value given that the values are of the same data type.
boolean	containsNull()	Returns true if this value is NULL or contains NULL value.
boolean	equals(Object other)	Check if the two values have the same hash code.
BigDecimal	getBigDecimal()
boolean	getBoolean()	Returns this value as a Java boolean value.
byte	getByte()	Returns this value as a Java byte value.
byte[]	getBytes()
double	getDouble()	Returns this value as a Java double value.
float	getFloat()	Returns this value as a Java float value.
InputStream	getInputStream()
InputStream	getInputStream(long oneBasedOffset, long length)	Get the input stream
int	getInt()	Returns this value as a Java int value.
long	getLong()	Returns this value as a Java long value.
int	getMemory()	Get the memory used by this object.
Reader	getReader()
Reader	getReader(long oneBasedOffset, long length)	Get the reader
short	getShort()	Returns this value as a Java short value.
StringBuilder	getSQL(StringBuilder builder, int sqlFlags)	Appends the SQL statement of this object to the specified builder.
String	getString()	Get the value as a string.
TypeInfo	getType()	Returns the data type.
int	getValueType()	Get the value type.
int	hashCode()

Methods inherited from class Value

add, cache, castTo, charLength, clearCache, compareTo, compareWithNull, convertForAssignTo, convertTo, convertTo, convertTo, convertTo, convertTo, convertToAnyArray, convertToAnyRow, convertToBigint, convertToBoolean, convertToChar, convertToDate, convertToDouble, convertToEnum, convertToGeometry, convertToInt, convertToInt, convertToJavaObject, convertToReal, convertToSmallint, convertToTinyint, convertToUuid, divide, getBytesNoCopy, getDataConversionError, getDataConversionError, getHigherOrder, getHigherOrderKnown, getSignum, getTypeName, getUnsupportedExceptionForOperation, getValueTooLongException, isFalse, isTrue, modulus, multiply, negate, octetLength, rangeCheck, subtract, toString

Methods inherited from class VersionedValue

getCommittedValue, getCurrentValue, getOperationId, isCommitted

Methods inherited from class Object

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

Methods inherited from interface HasSQL

getSQL, getTraceSQL

Field Details

INSTANCE

public static final ValueNull INSTANCE

The main NULL instance.

PRECISION

static final int PRECISION

The precision of NULL.

See Also:

• Constant Field Values

DISPLAY_SIZE

static final int DISPLAY_SIZE

The display size of the textual representation of NULL.

See Also:

• Constant Field Values

Constructor Details

ValueNull

private ValueNull()

Method Details

getSQL

public StringBuilder getSQL(StringBuilder builder,
 int sqlFlags)

Description copied from interface: HasSQL

Appends the SQL statement of this object to the specified builder.

Parameters:

builder - string builder

sqlFlags - formatting flags

Returns:

the specified string builder

getType

public TypeInfo getType()

Description copied from interface: Typed

Returns the data type.

Specified by:

getType in interface Typed

Specified by:

getType in class Value

Returns:

the data type

getValueType

public int getValueType()

Description copied from class: Value

Get the value type.

Specified by:

getValueType in class Value

Returns:

the value type

getMemory

public int getMemory()

Description copied from class: Value

Get the memory used by this object.

Overrides:

getMemory in class Value

Returns:

the memory used in bytes

getString

public String getString()

Description copied from class: Value

Get the value as a string.

Specified by:

getString in class Value

Returns:

the string

getReader

public Reader getReader()

Overrides:

getReader in class Value

getReader

public Reader getReader(long oneBasedOffset,
 long length)

Description copied from class: Value

Get the reader

Overrides:

getReader in class Value

Parameters:

oneBasedOffset - the offset (1 means no offset)

length - the requested length

Returns:

the new reader

getBytes

public byte[] getBytes()

Overrides:

getBytes in class Value

getInputStream

public InputStream getInputStream()

Overrides:

getInputStream in class Value

getInputStream

public InputStream getInputStream(long oneBasedOffset,
 long length)

Description copied from class: Value

Get the input stream

Overrides:

getInputStream in class Value

Parameters:

oneBasedOffset - the offset (1 means no offset)

length - the requested length

Returns:

the new input stream

getBoolean

public boolean getBoolean()

Description copied from class: Value

Returns this value as a Java boolean value.

Overrides:

getBoolean in class Value

Returns:

value

See Also:

• Value.isTrue()
• Value.isFalse()

getByte

public byte getByte()

Description copied from class: Value

Returns this value as a Java byte value.

Overrides:

getByte in class Value

Returns:

value

getShort

public short getShort()

Description copied from class: Value

Returns this value as a Java short value.

Overrides:

getShort in class Value

Returns:

value

getInt

public int getInt()

Description copied from class: Value

Returns this value as a Java int value.

Overrides:

getInt in class Value

Returns:

value

getLong

public long getLong()

Description copied from class: Value

Returns this value as a Java long value.

Overrides:

getLong in class Value

Returns:

value

getBigDecimal

public BigDecimal getBigDecimal()

Overrides:

getBigDecimal in class Value

getFloat

public float getFloat()

Description copied from class: Value

Returns this value as a Java float value.

Overrides:

getFloat in class Value

Returns:

value

getDouble

public double getDouble()

Description copied from class: Value

Returns this value as a Java double value.

Overrides:

getDouble in class Value

Returns:

value

compareTypeSafe

public int compareTypeSafe(Value v,
 CompareMode mode,
 CastDataProvider provider)

Description copied from class: Value

Compare this value against another value given that the values are of the same data type.

Specified by:

compareTypeSafe in class Value

Parameters:

v - the other value

mode - the compare mode

provider - the cast information provider

Returns:

0 if both values are equal, -1 if the other value is smaller, and 1 otherwise

containsNull

public boolean containsNull()

Description copied from class: Value

Returns true if this value is NULL or contains NULL value.

Overrides:

containsNull in class Value

Returns:

true if this value is NULL or contains NULL value

hashCode

public int hashCode()

Specified by:

hashCode in class Value

equals

public boolean equals(Object other)

Description copied from class: Value

Check if the two values have the same hash code. No data conversion is made; this method returns false if the other object is not of the same class. For some values, compareTo may return 0 even if equals return false. Example: ValueDecimal 0.0 and 0.00.

Specified by:

equals in class Value

Parameters:

other - the other value

Returns:

true if they are equal