ai.rapids.cudf

Class HostColumnVector.ColumnBuilder

java.lang.Object

ai.rapids.cudf.HostColumnVector.ColumnBuilder

All Implemented Interfaces:

AutoCloseable

Enclosing class:

HostColumnVector

public static final class HostColumnVector.ColumnBuilder
extends Object
implements AutoCloseable

Build

Constructor Summary

Constructors

Constructor and Description
ColumnBuilder(HostColumnVector.DataType type, long estimatedRows)

Method Summary

Modifier and Type	Method and Description
HostColumnVector.ColumnBuilder	append(BigDecimal value)
HostColumnVector.ColumnBuilder	append(BigInteger unscaledVal)
HostColumnVector.ColumnBuilder	append(boolean value)
HostColumnVector.ColumnBuilder	append(byte value)
HostColumnVector.ColumnBuilder	append(byte[] value, int srcOffset, int length) Append multiple non-null byte values.
HostColumnVector.ColumnBuilder	append(double value)
HostColumnVector.ColumnBuilder	append(float value)
HostColumnVector.ColumnBuilder	append(int value)
HostColumnVector.ColumnBuilder	append(long value)
HostColumnVector.ColumnBuilder	append(short value)
HostColumnVector.ColumnBuilder	append(String value)
HostColumnVector.ColumnBuilder	appendByteList(byte[] value) Appends byte to a LIST of INT8/UINT8
HostColumnVector.ColumnBuilder	appendByteList(byte[] value, int srcOffset, int length) Appends bytes to a LIST of INT8/UINT8
HostColumnVector.ColumnBuilder	appendDecimal128(byte[] binary) Accepts a byte array containing the two's-complement representation of the unscaled value, which is in big-endian byte-order.
HostColumnVector.ColumnBuilder	appendLists(List... inputLists)
HostColumnVector.ColumnBuilder	appendNull()
HostColumnVector.ColumnBuilder	appendStructValues(HostColumnVector.StructData... inputList)
HostColumnVector.ColumnBuilder	appendStructValues(List<HostColumnVector.StructData> inputList)
HostColumnVector.ColumnBuilder	appendUTF8String(byte[] value)
HostColumnVector.ColumnBuilder	appendUTF8String(byte[] value, int srcOffset, int length)
HostColumnVector	build()
ColumnVector	buildAndPutOnDevice() Finish and create the immutable ColumnVector, copied to the device.
void	close()
HostColumnVector.ColumnBuilder	endList() If you want to build up a list column you can get `builder.getChild(0)` and append to than, then when you are done call `endList` and everything that was appended to that builder will now be in the next list.
HostColumnVector.ColumnBuilder	endStruct() If you want to build up a struct column you can get each child `builder.getChild(N)` and append to all of them, then when you are done call `endStruct` to update this builder.
HostColumnVector.ColumnBuilder	getChild(int index)
int	getCurrentByteIndex() Deprecated.
int	getCurrentIndex()
void	incrCurrentIndex() Deprecated.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ColumnBuilder

public ColumnBuilder(HostColumnVector.DataType type,
                     long estimatedRows)

Method Detail

build

public HostColumnVector build()

appendLists

public HostColumnVector.ColumnBuilder appendLists(List... inputLists)

appendStructValues

public HostColumnVector.ColumnBuilder appendStructValues(List<HostColumnVector.StructData> inputList)

appendStructValues

public HostColumnVector.ColumnBuilder appendStructValues(HostColumnVector.StructData... inputList)

appendNull

public final HostColumnVector.ColumnBuilder appendNull()

endStruct

public HostColumnVector.ColumnBuilder endStruct()

If you want to build up a struct column you can get each child `builder.getChild(N)` and append to all of them, then when you are done call `endStruct` to update this builder. Do not start to append to the child and then append a null to this without ending the struct first or you might not get the results that you expected.

Returns:

this for chaining.

endList

public HostColumnVector.ColumnBuilder endList()

If you want to build up a list column you can get `builder.getChild(0)` and append to than, then when you are done call `endList` and everything that was appended to that builder will now be in the next list. Do not start to append to the child and then append a null to this without ending the list first or you might not get the results that you expected.

Returns:

this for chaining.

incrCurrentIndex

@Deprecated
public void incrCurrentIndex()

Deprecated.

getCurrentIndex

public int getCurrentIndex()

getCurrentByteIndex

@Deprecated
public int getCurrentByteIndex()

Deprecated.

append

public final HostColumnVector.ColumnBuilder append(byte value)

append

public final HostColumnVector.ColumnBuilder append(short value)

append

public final HostColumnVector.ColumnBuilder append(int value)

append

public final HostColumnVector.ColumnBuilder append(long value)

append

public final HostColumnVector.ColumnBuilder append(float value)

append

public final HostColumnVector.ColumnBuilder append(double value)

append

public final HostColumnVector.ColumnBuilder append(boolean value)

append

public HostColumnVector.ColumnBuilder append(BigDecimal value)

append

public HostColumnVector.ColumnBuilder append(BigInteger unscaledVal)

append

public HostColumnVector.ColumnBuilder append(String value)

appendUTF8String

public HostColumnVector.ColumnBuilder appendUTF8String(byte[] value)

appendUTF8String

public HostColumnVector.ColumnBuilder appendUTF8String(byte[] value,
                                                       int srcOffset,
                                                       int length)

append

public HostColumnVector.ColumnBuilder append(byte[] value,
                                             int srcOffset,
                                             int length)

Append multiple non-null byte values.

appendByteList

public HostColumnVector.ColumnBuilder appendByteList(byte[] value)

Appends byte to a LIST of INT8/UINT8

appendByteList

public HostColumnVector.ColumnBuilder appendByteList(byte[] value,
                                                     int srcOffset,
                                                     int length)

Appends bytes to a LIST of INT8/UINT8

appendDecimal128

public HostColumnVector.ColumnBuilder appendDecimal128(byte[] binary)

Accepts a byte array containing the two's-complement representation of the unscaled value, which is in big-endian byte-order. Then, transforms it into the representation of cuDF Decimal128 for appending. This method is more efficient than `append(BigInteger unscaledVal)` if we can directly access the two's-complement representation of a BigDecimal without encoding via the method `toByteArray`.

getChild

public HostColumnVector.ColumnBuilder getChild(int index)

buildAndPutOnDevice

public final ColumnVector buildAndPutOnDevice()

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

close

public void close()

Specified by:

close in interface AutoCloseable

toString

public String toString()

Overrides:

toString in class Object