HostColumnVectorCore (cudfjni 25.04.0 API)

java.lang.Object
- ai.rapids.cudf.HostColumnVectorCore

所有已实现的接口

AutoCloseable

已知直接子类

HostColumnVector
```
public class HostColumnVectorCore
extends Object
implements AutoCloseable
```
一个类，包含主机端 Column Vector API 和 OffHeapState。HostColumnVector 的任何子对象都将通过此类实例化。

嵌套类摘要

嵌套类
修饰符和类型类和描述

protected static class HostColumnVectorCore.OffHeapState
持有列向量的堆外状态，以便即使发生内存泄漏也能进行清理。

嵌套类
修饰符和类型	类和描述
`protected static class`	`HostColumnVectorCore.OffHeapState` 持有列向量的堆外状态，以便即使发生内存泄漏也能进行清理。

字段摘要

字段
修饰符和类型	字段和描述
`protected List<HostColumnVectorCore>`	`children`
`protected Optional<Long>`	`nullCount`
`protected HostColumnVectorCore.OffHeapState`	`offHeap`
`protected long`	`rows`
`protected DType`	`type`

构造器摘要

构造器
构造器和描述
`HostColumnVectorCore(DType type, long rows, Optional<Long> nullCount, HostMemoryBuffer data, HostMemoryBuffer validity, HostMemoryBuffer offsets, List<HostColumnVectorCore> nestedChildren)`

方法摘要

所有方法静态方法实例方法具体方法
修饰符和类型	方法和描述
`void`	`close()` 关闭列的方法
`protected static byte[]`	`convertDecimal128FromJavaToCudf(byte[] bytes)`
`BigDecimal`	`getBigDecimal(long index)` 获取索引处的 BigDecimal 值。
`boolean`	`getBoolean(long index)` 获取索引处的 boolean 值
`byte`	`getByte(long index)` 获取索引处的值。
`byte[]`	`getBytesFromList(long rowIndex)` 警告：int8 或 uint8 列表的特殊情况，不支持空列表值或嵌套列表。从 int8 或 uint8 类型的列表列中获取索引处的字节数组。
`HostColumnVectorCore`	`getChildColumnView(int childIndex)`
`HostMemoryBuffer`	`getData()` 返回给定主机端列向量的数据缓冲区
`double`	`getDouble(long index)` 获取索引处的值。
`long`	`getEndListOffset(long index)` 获取索引处列表或字符串的结束元素偏移量。
`float`	`getFloat(long index)` 获取索引处的值。
`HostMemoryBuffer`	`getHostBufferFor(BufferType type)` 获取此列的原始主机缓冲区。
`long`	`getHostMemorySize()` 返回用于存储列/有效性数据（非元数据）的主机内存量。
`int`	`getInt(long index)` 获取索引处的值。
`String`	`getJavaString(long index)` 获取索引处的值。
`List`	`getList(long rowIndex)` 警告：严格用于测试。
`long`	`getLong(long index)` 获取索引处的值。
`long`	`getNullCount()` 返回数据中的 null 数量。
`int`	`getNumChildren()` 返回此列的子对象数量
`HostMemoryBuffer`	`getOffsets()` 返回偏移量缓冲区
`long`	`getRowCount()` 返回给定主机端列向量的行数
`short`	`getShort(long index)` 获取索引处的值。
`long`	`getStartListOffset(long index)` 获取索引处列表或字符串的起始元素偏移量
`HostColumnVector.StructData`	`getStruct(int rowIndex)` 警告：严格用于测试。
`DType`	`getType()` 返回此向量的类型。
`byte[]`	`getUTF8(long index)` 获取索引处的原始 UTF8 字节。
`HostMemoryBuffer`	`getValidity()` 返回给定主机端列向量的有效性缓冲区
`boolean`	`hasNulls()` 返回向量是否包含 null。
`boolean`	`hasValidityVector()` 返回向量是否已分配有效性向量。
`boolean`	`isNull(long rowIndex)` 返回布尔值指示给定行索引处的元素是否为 null 的方法
`String`	`toString()`

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - offHeap
```
protected final HostColumnVectorCore.OffHeapState offHeap
```
  - type
```
protected final DType type
```
  - rows
```
protected long rows
```
  - nullCount
```
protected Optional<Long> nullCount
```
  - children
```
protected List<HostColumnVectorCore> children
```
- 构造器详细信息
  - HostColumnVectorCore
```
public HostColumnVectorCore(DType type,
                            long rows,
                            Optional<Long> nullCount,
                            HostMemoryBuffer data,
                            HostMemoryBuffer validity,
                            HostMemoryBuffer offsets,
                            List<HostColumnVectorCore> nestedChildren)
```
- 方法详细信息
  - getType
```
public DType getType()
```
    返回此向量的类型。
  - getData
```
public HostMemoryBuffer getData()
```
    返回给定主机端列向量的数据缓冲区
  - getValidity
```
public HostMemoryBuffer getValidity()
```
    返回给定主机端列向量的有效性缓冲区
  - getOffsets
```
public HostMemoryBuffer getOffsets()
```
    返回偏移量缓冲区
  - getChildColumnView
```
public HostColumnVectorCore getChildColumnView(int childIndex)
```
  - getNullCount
```
public long getNullCount()
```
    返回数据中的 null 数量。请注意，这可能是一个非常耗费性能的操作，因为如果 null 数量未知，则会进行计算。
  - getRowCount
```
public long getRowCount()
```
    返回给定主机端列向量的行数
  - getNumChildren
```
public int getNumChildren()
```
    返回此列的子对象数量
  - getHostBufferFor
```
public HostMemoryBuffer getHostBufferFor(BufferType type)
```
    获取此列的原始主机缓冲区。此方法需谨慎使用。缓冲区的生命周期与列的生命周期绑定（不要关闭缓冲区，列会负责处理）。不要修改缓冲区的内容，否则可能会对列的操作产生负面影响。数据必须位于主机上此方法才能正常工作。
    
    参数
    
    type - 要访问的缓冲区类型。
    
    返回值
    
    底层缓冲区；如果此列没有关联的缓冲区，则返回 null。请注意，如果列为空，则可能没有与该列关联的任何缓冲区。
  - getByte
```
public byte getByte(long index)
```
    获取索引处的值。
  - getShort
```
public final short getShort(long index)
```
    获取索引处的值。
  - getInt
```
public final int getInt(long index)
```
    获取索引处的值。
  - getStartListOffset
```
public long getStartListOffset(long index)
```
    获取索引处列表或字符串的起始元素偏移量
  - getEndListOffset
```
public long getEndListOffset(long index)
```
    获取索引处列表或字符串的结束元素偏移量。
  - getLong
```
public final long getLong(long index)
```
    获取索引处的值。
  - getFloat
```
public final float getFloat(long index)
```
    获取索引处的值。
  - getDouble
```
public final double getDouble(long index)
```
    获取索引处的值。
  - getBoolean
```
public final boolean getBoolean(long index)
```
    获取索引处的 boolean 值
  - getBigDecimal
```
public final BigDecimal getBigDecimal(long index)
```
    获取索引处的 BigDecimal 值。
  - getUTF8
```
public byte[] getUTF8(long index)
```
    获取索引处的原始 UTF8 字节。此 API 比 getJavaString 快，但仍非理想选择，因为它会将数据复制到堆上。
  - getJavaString
```
public String getJavaString(long index)
```
    获取索引处的值。此 API 速度较慢，因为它必须转换字符串表示形式。请谨慎使用。
  - getBytesFromList
```
public byte[] getBytesFromList(long rowIndex)
```
    警告：int8 或 uint8 列表的特殊情况，不支持空列表值或嵌套列表。从 int8 或 uint8 类型的列表列中获取索引处的字节数组。此列可能不是列表的列表，并且可能没有 null 值。
  - getList
```
public List getList(long rowIndex)
```
    警告：严格用于测试。此调用在生产环境中效率低下。
  - getStruct
```
public HostColumnVector.StructData getStruct(int rowIndex)
```
    警告：严格用于测试。此调用在生产环境中效率低下。
  - isNull
```
public boolean isNull(long rowIndex)
```
    返回布尔值指示给定行索引处的元素是否为 null 的方法
    
    参数
    
    rowIndex - 行索引
    
    返回值
    
    如果为 null 则为 true，否则为 false
  - hasValidityVector
```
public boolean hasValidityVector()
```
    返回向量是否已分配有效性向量。
  - hasNulls
```
public boolean hasNulls()
```
    返回向量是否包含 null。请注意，这可能是一个非常耗费性能的操作，因为如果 null 数量未知，则会进行计算。
  - getHostMemorySize
```
public long getHostMemorySize()
```
    返回用于存储列/有效性数据（非元数据）的主机内存量。
  - close
```
public void close()
```
    关闭列的方法
    
    指定者
    
    在接口 AutoCloseable 中指定：close
  - toString
```
public String toString()
```
    覆盖
    
    覆盖类 Object 中的方法：toString
  - convertDecimal128FromJavaToCudf
```
protected static byte[] convertDecimal128FromJavaToCudf(byte[] bytes)
```

类 HostColumnVectorCore

嵌套类摘要

字段摘要

构造器摘要

方法摘要

从类 java.lang.Object 继承的方法

字段详细信息

offHeap

type

rows

nullCount

children

构造器详细信息

HostColumnVectorCore

方法详细信息

getType

getData

getValidity

getOffsets

getChildColumnView

getNullCount

getRowCount

getNumChildren

getHostBufferFor

getByte

getShort

getInt

getStartListOffset

getEndListOffset

getLong

getFloat

getDouble

getBoolean

getBigDecimal

getUTF8

getJavaString

getBytesFromList

getList

getStruct

isNull

hasValidityVector

hasNulls

getHostMemorySize

close

toString

convertDecimal128FromJavaToCudf