ai.rapids.cudf

类 ChunkedPack

java.lang.Object

ai.rapids.cudf.ChunkedPack

所有已实现的接口

AutoCloseable

public class ChunkedPack
extends Object
implements AutoCloseable

cudf::chunked_pack 的 JNI 接口。ChunkedPack 具有类似迭代器的 API，包含熟悉的 `hasNext` 和 `next` 方法。`next` 应在循环中使用，直到 `hasNext` 返回 false。然而，`ChunkedPack.next` 是特殊的，因为它接受 `DeviceMemoryBuffer` 作为参数，这意味着调用者可以调用 `next` 并传入之前分配的任何反弹缓冲区。不要求每次反弹缓冲区都相同，唯一的要求是它们的尺寸都相同，并且与传递给 `Table.makeChunkedPack`（实例化此类的函数）的尺寸匹配。ChunkedPack 的用户在使用完毕后必须调用 `.close()` 来清理主机和设备资源。

构造器摘要

构造器

构造器和说明
ChunkedPack(long nativePtr) 此构造器由 `Table.makeChunkedPack` 在创建原生 `cudf::chunked_pack` 后调用。

方法摘要

修饰符和类型	方法和说明
PackedColumnMetadata	buildMetadata() 生成不透明的表元数据，这些元数据可以在以后通过 `cudf::unpack` 解包。
void	close()
long	getTotalContiguousSize() 获取我们正在打包的表的最终连续大小。
boolean	hasNext() 用于确保 `ChunkedPack` 仍有工作待执行的方法。
long	next(DeviceMemoryBuffer userPtr) 将表的下一个连续块放入 `userPtr` 中。

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

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

构造器详细信息

ChunkedPack

public ChunkedPack(long nativePtr)

此构造器由 `Table.makeChunkedPack` 在创建原生 `cudf::chunked_pack` 后调用。

参数

nativePtr - 指向 `cudf::chunked_pack` 的指针

方法详细信息

getTotalContiguousSize

public long getTotalContiguousSize()

获取我们正在打包的表的最终连续大小。这是最终缓冲区应有的大小，就像用户调用 `cudf::pack` 而不是此方法一样。

返回

以连续布局表示的表的总字节数

hasNext

public boolean hasNext()

用于确保 `ChunkedPack` 仍有工作待执行的方法。应调用此方法后调用 `next`，直到 `hasNext` 返回 false。

返回

如果仍有工作待执行（应调用 `next`），则为 true；否则为 false。

next

public long next(DeviceMemoryBuffer userPtr)

将表的下一个连续块放入 `userPtr` 中。如果 `hasNext` 为 false，此方法将抛出异常。

参数

userPtr - 用于此迭代的反弹缓冲区

返回

已成功放入 `userPtr` 中的字节数。此值最多为 `userPtr.getLength()`。

buildMetadata

public PackedColumnMetadata buildMetadata()

生成不透明的表元数据，这些元数据可以在以后通过 `cudf::unpack` 解包。

返回

引用 cuDF 打包表元数据的 `PackedColumnMetadata` 实例

close

public void close()

指定者

在接口 AutoCloseable 中指定： close