HostColumnVector.Builder (cudfjni 24.12.0 API)

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

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`HostColumnVector.Builder`	`append(BigDecimal value)` Append java.math.BigDecimal into HostColumnVector with UNNECESSARY RoundingMode.
`HostColumnVector.Builder`	`append(BigDecimal value, RoundingMode roundingMode)` Append java.math.BigDecimal into HostColumnVector with user-defined RoundingMode.
`HostColumnVector.Builder`	`append(boolean value)`
`HostColumnVector.Builder`	`append(byte value)`
`HostColumnVector.Builder`	`append(byte value, long count)`
`HostColumnVector.Builder`	`append(double value)`
`HostColumnVector.Builder`	`append(float value)`
`HostColumnVector.Builder`	`append(HostColumnVector columnVector)` Append this vector to the end of this vector
`HostColumnVector.Builder`	`append(int value)`
`HostColumnVector.Builder`	`append(long value)`
`HostColumnVector.Builder`	`append(short value)`
`HostColumnVector.Builder`	`append(String value)`
`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)`
`HostColumnVector.Builder`	`appendBoxed(BigDecimal... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Boolean... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Byte... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Double... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Float... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Integer... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Long... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(Short... values)` Append multiple values.
`HostColumnVector.Builder`	`appendBoxed(String... values)` Append multiple values.
`HostColumnVector.Builder`	`appendNull()` Append null value.
`HostColumnVector.Builder`	`appendUnscaledDecimal(BigInteger value)`
`HostColumnVector.Builder`	`appendUnscaledDecimal(int value)`
`HostColumnVector.Builder`	`appendUnscaledDecimal(long 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)`
`HostColumnVector`	`build()` Finish and create the immutable CudfColumn.
`ColumnVector`	`buildAndPutOnDevice()` Finish and create the immutable ColumnVector, copied to the device.
`void`	`close()` Close this builder and free memory if the CudfColumn wasn't generated.
`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 Detail
  - 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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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:
    
    {@link - IndexOutOfBoundsException}
    
    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

Class HostColumnVector.Builder

Method Summary

Methods inherited from class java.lang.Object

Method Detail

append

append

append

append

append

append

append

append

append

append

appendUnscaledDecimal

appendUnscaledDecimal

appendUnscaledDecimal

append

appendUTF8String

appendUTF8String

appendArray

appendArray

appendArray

appendArray

appendArray

appendArray

appendUnscaledDecimalArray

appendUnscaledDecimalArray

appendBoxed

appendBoxed

appendBoxed

appendBoxed

appendBoxed

appendBoxed

appendBoxed

appendBoxed

appendBoxed

append

appendNull

setNullAt

build

buildAndPutOnDevice

close

toString