Package convex.core.data

Class Vectors

java.lang.Object

convex.core.data.Vectors

public class Vectors
extends Object

Static utility functions for working with Vectors

Field Summary

Fields

Modifier and Type	Field	Description
protected static final int	BITMASK
protected static final int	BITS_PER_LEVEL
static final int	CHUNK_SIZE
static final int	MAX_ENCODING_LENGTH

Constructor Summary

Constructors

Constructor	Description
Vectors()

Method Summary

Modifier and Type	Method	Description
static <T extends ACell> AVector<T>	create(ACell[] elements)	Create a vector from an array of elements.
static <T extends ACell> AVector<T>	create(ACell[] elements, int offset, int length)	Creates a canonical AVector with the given elements
static <R extends ACell> AVector<R>	create(ASequence<R> list)	Creates a Vector from the contents of an arbitrary sequence
static <R extends ACell, T extends ACell> AVector<R>	create(Collection<?> elements)	Coerces a collection to a vector.
static <T extends ACell> AVector<T>	empty()
static <T extends ACell> AVector<T>	of(Object... elements)	Creates a vector with the given values.
static <T extends ACell> AVector<T>	read(Blob b, int pos)	Reads a Vector for the specified Blob.
static <T extends ACell> AVector<T>	repeat(T m, int count)
static <T extends ACell> AVector<T>	wrap(ACell[] elements)	Create a vector directly wrapping an array of cells.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

BITS_PER_LEVEL

protected static final int BITS_PER_LEVEL

See Also:

• Constant Field Values

CHUNK_SIZE

public static final int CHUNK_SIZE

See Also:

• Constant Field Values

BITMASK

protected static final int BITMASK

See Also:

• Constant Field Values

MAX_ENCODING_LENGTH

public static final int MAX_ENCODING_LENGTH

Constructor Details

Vectors

public Vectors()

Method Details

create

public static <T extends ACell> AVector<T> create(ACell[] elements,
 int offset,
 int length)

Creates a canonical AVector with the given elements

Parameters:

elements - Elements to include

offset - Offset into element array

length - Number of elements to take

Returns:

New vector with the specified elements

create

public static <T extends ACell> AVector<T> create(ACell[] elements)

Create a vector from an array of elements.

Type Parameters:

T - Type of elements

Parameters:

elements - Elements to include

Returns:

New vector with the specified elements

wrap

public static <T extends ACell> AVector<T> wrap(ACell[] elements)

Create a vector directly wrapping an array of cells. Do not mutate array after creation!

Type Parameters:

T - Type of elements

Parameters:

elements - Elements to include

Returns:

New vector wrapping the specified elements

create

public static <R extends ACell,
T extends ACell>
AVector<R> create(Collection<?> elements)

Coerces a collection to a vector. Not necessarily the most efficient. Performs an unchecked cast.

Type Parameters:

R - Type of Vector elements to produce

T - Type of source collection elements

Parameters:

elements - Elements to include

Returns:

New vector with the specified collection of elements

create

public static <R extends ACell> AVector<R> create(ASequence<R> list)

Creates a Vector from the contents of an arbitrary sequence

Type Parameters:

R - Type of sequence elements

Parameters:

list - Any sequential collection

Returns:

Vector of elements

empty

public static <T extends ACell> AVector<T> empty()

of

@SafeVarargs
public static <T extends ACell> AVector<T> of(Object... elements)

Creates a vector with the given values. Performs conversion to CVM types.

Type Parameters:

T - Type of elements (after CVM conversion)

Parameters:

elements - Elements to include

Returns:

New Vector

repeat

public static <T extends ACell> AVector<T> repeat(T m,
 int count)

read

public static <T extends ACell> AVector<T> read(Blob b,
 int pos)
                                         throws BadFormatException

Reads a Vector for the specified Blob. Assumes Tag byte already checked. Distinguishes between child types according to count.

Type Parameters:

T - Type of elements

Parameters:

b - Blob to read from

pos - Start position in Blob (location of tag byte)

Returns:

New decoded instance

Throws:

BadFormatException - In the event of any encoding error