Package convex.core.data

Class LongBlob

java.lang.Object

convex.core.data.AObject

convex.core.data.ACell

convex.core.data.ACountable<CVMLong>

convex.core.data.ABlobLike<CVMLong>

convex.core.data.ABlob

convex.core.data.ALongBlob

convex.core.data.LongBlob

All Implemented Interfaces:

IValidated, IWriteable, Comparable<ABlobLike<?>>

public final class LongBlob
extends ALongBlob

Wrapper for an 8-byte long as a Blob We use this mainly for efficient management of indexes using Longs in Indexes.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	MAX_ENCODING_LENGTH
static final LongBlob	ZERO

Fields inherited from class convex.core.data.ALongBlob

HEX_LENGTH, LENGTH, value

Fields inherited from class convex.core.data.ABlob

count

Fields inherited from class convex.core.data.ACell

cachedRef, memorySize

Fields inherited from class convex.core.data.AObject

encoding

Method Summary

Modifier and Type	Method	Description
static LongBlob	create(long value)
static LongBlob	create(String string)
int	encodeRaw(byte[] bs, int pos)	Writes this Blob's encoding to a byte array, excluding the tag byte
boolean	equals(ABlob a)	Determines if this Blob is equal to another Blob.
int	estimatedEncodingSize()	Estimate the encoded data size for this Cell.
long	hexMatch(ABlobLike<?> b)	Computes the length of the longest common hex prefix between two blobs
long	hexMatch(ABlobLike<?> b, long start, long length)	Returns the number of matching hex digits in the given hex range of another Blob.
ABlob	slice(long start, long end)	Gets a contiguous slice of this Blob, as a new Blob.
Blob	toFlatBlob()	Converts the contents of this value to a flat array-backed Blob instance.
protected void	updateDigest(MessageDigest digest)

Methods inherited from class convex.core.data.ALongBlob

append, appendHex, byteAt, byteAtUnchecked, calcMemorySize, compareTo, compareTo, createRef, equalsBytes, equalsBytes, getByteBuffer, getBytes, getChunk, getHexDigit, getRef, getRefCount, hexLength, isCanonical, isChunkPacked, isEmbedded, isFullyPacked, longValue, read, toCanonical, updateRefs

Methods inherited from class convex.core.data.ABlob

computeHash, count, empty, encode, equals, get, getContentHash, getElementRef, getTag, getType, hashCode, isCVMValue, print, read, replaceSlice, shortAt, size, slice, toBlob, toByteBuffer, validate, validateCell

Methods inherited from class convex.core.data.ABlobLike

getBytes, hexEquals, isDataValue, toHexString, toHexString

Methods inherited from class convex.core.data.ACountable

isEmpty

Methods inherited from class convex.core.data.ACell

attachMemorySize, attachRef, cachedEncoding, cachedHash, createEncoding, equals, genericEquals, getCanonical, getChildRefs, getEncoding, getEncodingLength, getHash, getMemorySize, getMemorySize, getRef, toCVMString, toString

Methods inherited from class convex.core.data.AObject

attachEncoding, print, print

Methods inherited from class java.lang.Object

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

Field Details

MAX_ENCODING_LENGTH

public static final int MAX_ENCODING_LENGTH

See Also:

• Constant Field Values

ZERO

public static final LongBlob ZERO

Method Details

create

public static LongBlob create(String string)

create

public static LongBlob create(long value)

slice

public ABlob slice(long start,
 long end)

Description copied from class: ABlob

Gets a contiguous slice of this Blob, as a new Blob. Shares underlying backing data where possible

Specified by:

slice in class ALongBlob

Parameters:

start - Start position for the created slice (inclusive)

end - End of the slice (exclusive)

Returns:

A blob of the specified length, representing a slice of this blob, or null if the slice is invalid

updateDigest

protected void updateDigest(MessageDigest digest)

Specified by:

updateDigest in class ABlob

hexMatch

public long hexMatch(ABlobLike<?> b)

Description copied from class: ABlobLike

Computes the length of the longest common hex prefix between two blobs

Overrides:

hexMatch in class ABlobLike<CVMLong>

Parameters:

b - Blob to compare with

Returns:

The length of the longest common prefix in hex digits

equals

public boolean equals(ABlob a)

Description copied from class: ABlob

Determines if this Blob is equal to another Blob. Blobs are defined to be equal if they have the same encoded representation, i.e. if and only if all of the following are true: - Blobs are of the same length - All byte values are equal

Specified by:

equals in class ALongBlob

Parameters:

a - Blob to compare with

Returns:

true if Blobs are equal, false otherwise

encodeRaw

public int encodeRaw(byte[] bs,
 int pos)

Description copied from class: ABlob

Writes this Blob's encoding to a byte array, excluding the tag byte

Specified by:

encodeRaw in class ABlob

Parameters:

bs - A byte array to which to write the encoding

pos - The offset into the byte array

Returns:

New position after writing

estimatedEncodingSize

public int estimatedEncodingSize()

Description copied from interface: IWriteable

Estimate the encoded data size for this Cell. Used for quickly sizing buffers. Implementations should try to return a size that is highly likely to contain the entire object when encoded, including the tag byte. Should not traverse soft Refs, i.e. must be usable on arbitrary partial data structures

Returns:

The estimated size for the binary representation of this object.

hexMatch

public long hexMatch(ABlobLike<?> b,
 long start,
 long length)

Description copied from class: ABlobLike

Returns the number of matching hex digits in the given hex range of another Blob. Assumes range is valid for both blobs. Returns length if this Blob is exactly equal to the specified hex range.

Overrides:

hexMatch in class ALongBlob

Parameters:

b - Blob to compare with

start - Start position (in hex digits)

length - Length to compare (in hex digits)

Returns:

The number of matching hex characters

toFlatBlob

public Blob toFlatBlob()

Description copied from class: ABlobLike

Converts the contents of this value to a flat array-backed Blob instance. Warning: might be O(n) in size of Blob, may not be canonical etc.

Specified by:

toFlatBlob in class ALongBlob

Returns:

A Blob instance containing the same data as this value. Might be `this` if already a flat Blob.