Package ai.rapids.cudf

Class HostColumnVector.Builder

java.lang.Object

ai.rapids.cudf.HostColumnVector.Builder

All Implemented Interfaces:

AutoCloseable

Enclosing class:

HostColumnVector

public static final class HostColumnVector.Builder
extends Object
implements AutoCloseable

Method Summary

Modifier and Type	Method	Description
final HostColumnVector.Builder	append(boolean value)
final HostColumnVector.Builder	append(byte value)
final HostColumnVector.Builder	append(byte value, long count)
final HostColumnVector.Builder	append(double value)
final HostColumnVector.Builder	append(float value)
final HostColumnVector.Builder	append(int value)
final HostColumnVector.Builder	append(long value)
final HostColumnVector.Builder	append(short value)
final HostColumnVector.Builder	append(HostColumnVector columnVector)	Append this vector to the end of this vector
HostColumnVector.Builder	append(String value)
final HostColumnVector.Builder	append(BigDecimal value)	Append java.math.BigDecimal into HostColumnVector with UNNECESSARY RoundingMode.
final HostColumnVector.Builder	append(BigDecimal value, RoundingMode roundingMode)	Append java.math.BigDecimal into HostColumnVector with user-defined RoundingMode.
HostColumnVector.Builder	appendArray(byte... values)
HostColumnVector.Builder	appendArray(double... values)
HostColumnVector.Builder	appendArray(float... values)
HostColumnVector.Builder	appendArray(int... values)
HostColumnVector.Builder	appendArray(long... values)
HostColumnVector.Builder	appendArray(short... values)
final HostColumnVector.Builder	appendBoxed(Boolean... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(Byte... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(Double... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(Float... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(Integer... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(Long... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(Short... values)	Append multiple values.
final HostColumnVector.Builder	appendBoxed(String... values)	Append multiple values.
HostColumnVector.Builder	appendBoxed(BigDecimal... values)	Append multiple values.
final HostColumnVector.Builder	appendNull()	Append null value.
final HostColumnVector.Builder	appendUnscaledDecimal(int value)
final HostColumnVector.Builder	appendUnscaledDecimal(long value)
final HostColumnVector.Builder	appendUnscaledDecimal(BigInteger value)
HostColumnVector.Builder	appendUnscaledDecimalArray(int... values)
HostColumnVector.Builder	appendUnscaledDecimalArray(long... values)
HostColumnVector.Builder	appendUTF8String(byte[] value)
HostColumnVector.Builder	appendUTF8String(byte[] value, int offset, int length)
final HostColumnVector	build()	Finish and create the immutable CudfColumn.
final ColumnVector	buildAndPutOnDevice()	Finish and create the immutable ColumnVector, copied to the device.
final void	close()	Close this builder and free memory if the CudfColumn wasn't generated.
final HostColumnVector.Builder	setNullAt(long index)	Set a specific index to null.
String	toString()

Methods inherited from class java.lang.Object

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

Method Details

append

public final HostColumnVector.Builder append(boolean value)

append

public final HostColumnVector.Builder append(byte value)

append

public final HostColumnVector.Builder append(byte value,
 long count)

append

public final HostColumnVector.Builder append(short value)

append

public final HostColumnVector.Builder append(int value)

append

public final HostColumnVector.Builder append(long value)

append

public final HostColumnVector.Builder append(float value)

append

public final HostColumnVector.Builder append(double value)

append

public final HostColumnVector.Builder append(BigDecimal value)

Append java.math.BigDecimal into HostColumnVector with UNNECESSARY RoundingMode. Input decimal should have a larger scale than column vector.Otherwise, an ArithmeticException will be thrown while rescaling. If unscaledValue after rescaling exceeds the max precision of rapids type, an ArithmeticException will be thrown while extracting integral.

Parameters:

value - BigDecimal value to be appended

append

public final HostColumnVector.Builder append(BigDecimal value,
 RoundingMode roundingMode)

Append java.math.BigDecimal into HostColumnVector with user-defined RoundingMode. Input decimal will be rescaled according to scale of column type and RoundingMode before appended. If unscaledValue after rescaling exceeds the max precision of rapids type, an ArithmeticException will be thrown.

Parameters:

value - BigDecimal value to be appended

roundingMode - rounding mode determines rescaling behavior

appendUnscaledDecimal

public final HostColumnVector.Builder appendUnscaledDecimal(int value)

appendUnscaledDecimal

public final HostColumnVector.Builder appendUnscaledDecimal(long value)

appendUnscaledDecimal

public final HostColumnVector.Builder appendUnscaledDecimal(BigInteger value)

append

public HostColumnVector.Builder append(String value)

appendUTF8String

public HostColumnVector.Builder appendUTF8String(byte[] value)

appendUTF8String

public HostColumnVector.Builder appendUTF8String(byte[] value,
 int offset,
 int length)

appendArray

public HostColumnVector.Builder appendArray(byte... values)

appendArray

public HostColumnVector.Builder appendArray(short... values)

appendArray

public HostColumnVector.Builder appendArray(int... values)

appendArray

public HostColumnVector.Builder appendArray(long... values)

appendArray

public HostColumnVector.Builder appendArray(float... values)

appendArray

public HostColumnVector.Builder appendArray(double... values)

appendUnscaledDecimalArray

public HostColumnVector.Builder appendUnscaledDecimalArray(int... values)

appendUnscaledDecimalArray

public HostColumnVector.Builder appendUnscaledDecimalArray(long... values)

appendBoxed

public HostColumnVector.Builder appendBoxed(BigDecimal... values)
                                     throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Byte... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Boolean... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Short... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Integer... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Long... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Float... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(Double... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

appendBoxed

public final HostColumnVector.Builder appendBoxed(String... values)
                                           throws IndexOutOfBoundsException

Append multiple values. This is very slow and should really only be used for tests.

Parameters:

values - the values to append, including nulls.

Returns:

this for chaining.

Throws:

IndexOutOfBoundsException

append

public final HostColumnVector.Builder append(HostColumnVector columnVector)

Append this vector to the end of this vector

Parameters:

columnVector - - Vector to be added

Returns:

- The CudfColumn based on this builder values

appendNull

public final HostColumnVector.Builder appendNull()

Append null value.

setNullAt

public final HostColumnVector.Builder setNullAt(long index)

Set a specific index to null.

Parameters:

index -

build

public final HostColumnVector build()

Finish and create the immutable CudfColumn.

buildAndPutOnDevice

public final ColumnVector buildAndPutOnDevice()

Finish and create the immutable ColumnVector, copied to the device.

close

public final void close()

Close this builder and free memory if the CudfColumn wasn't generated. Verifies that the data was released even in the case of an error.

Specified by:

close in interface AutoCloseable

toString

public String toString()

Overrides:

toString in class Object