填充

文件
file	lists/filling.hpp
	用于单个列表序列的列 API。

函数
std::unique_ptr< 列 >	cudf::lists::sequences (column_view const &starts, column_view const &sizes, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个列表列，其中每行包含由 (start, size) 参数对指定的值序列。更多...
std::unique_ptr< 列 >	cudf::lists::sequences (column_view const &starts, column_view const &steps, column_view const &sizes, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个列表列，其中每行包含由 (start, step, size) 参数对指定的值序列。更多...

详细说明

函数文档

sequences() [1/2]

std::unique_ptr<列> cudf::lists::sequences	(	column_view const &	starts,
		column_view const &	sizes,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个列表列，其中每行包含由 (start, size) 参数对指定的值序列。

创建一个列表列，其中每行是一个值序列，从 start 值开始，递增一，其基数由 size 值指定。用于生成每个列表的 start 和 size 值取自输入 starts 和 sizes 列的对应行。

• sizes 必须是整数类型的列。
• 所有输入列不能为空值。
• 如果 sizes 列的任何行包含负值，则输出未定义。

starts = [0, 1, 2, 3, 4]
sizes = [0, 2, 2, 1, 3]
 
output = [ [], [1, 2], [2, 3], [3], [4, 5, 6] ]

异常

cudf::logic_error	如果 sizes 列不是整数类型。
cudf::logic_error	如果任何输入列包含空值。
cudf::logic_error	如果 starts 和 sizes 列大小不同。
std::overflow_error	如果输出列超出列大小限制。

参数

starts	结果序列中的起始值。
sizes	结果序列中的值数量。
stream	用于设备内存操作和内核启动的 CUDA 流。
mr	用于分配返回列的设备内存的设备内存资源。

返回

包含生成序列的结果列。

sequences() [2/2]

std::unique_ptr<列> cudf::lists::sequences	(	column_view const &	starts,
		column_view const &	steps,
		column_view const &	sizes,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个列表列，其中每行包含由 (start, step, size) 参数对指定的值序列。

创建一个列表列，其中每行是一个值序列，从 start 值开始，按 step 值递增，其基数由 size 值指定。用于生成每个列表的 start、step 和 size 值取自输入 starts、steps 和 sizes 列的对应行。

• sizes 必须是整数类型的列。
• starts 和 steps 列必须具有相同的类型。
• 所有输入列不能为空值。
• 如果 sizes 列的任何行包含负值，则输出未定义。

starts = [0, 1, 2, 3, 4]
steps = [2, 1, 1, 1, -3]
sizes = [0, 2, 2, 1, 3]
 
output = [ [], [1, 2], [2, 3], [3], [4, 1, -2] ]

异常

cudf::logic_error	如果 sizes 列不是整数类型。
cudf::logic_error	如果任何输入列包含空值。
cudf::logic_error	如果 starts 和 steps 列类型不同。
cudf::logic_error	如果 starts、steps 和 sizes 列大小不同。
std::overflow_error	如果输出列超出列大小限制。

参数

starts	结果序列中的起始值。
steps	结果序列的递增值。
sizes	结果序列中的值数量。
stream	用于设备内存操作和内核启动的 CUDA 流。
mr	用于分配返回列的设备内存的设备内存资源。

返回

包含生成序列的结果列。