文件
文件	lists/combine.hpp

枚举
枚举类	cudf::lists::concatenate_null_policy { 忽略 , 输出行为空 }
	标志，用于指定是否忽略串联中的空列表元素，或者涉及空列表元素的整个串联结果将成为空元素。

函数
std::unique_ptr< 列 >	cudf::lists::concatenate_rows (表视图 const &input, concatenate_null_policy 空值策略=concatenate_null_policy::IGNORE, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	按行串联多个列表列到一个单独的列表列中。更多...

std::unique_ptr< 列 >	cudf::lists::concatenate_list_elements (列视图 const &input, concatenate_null_policy 空值策略=concatenate_null_policy::IGNORE, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	将列表列同一行中的多个列表串联成一个单独的列表。更多...

详细描述

函数文档

◆ concatenate_list_elements()

std::unique_ptr<列> cudf::lists::concatenate_list_elements	(	列视图 const &	输入,
		concatenate_null_policy	空值策略 = `concatenate_null_policy::IGNORE`,
		rmm::cuda_stream_view	流 = `cudf::get_default_stream()`,
		rmm::device_async_resource_ref	mr = `cudf::get_current_device_resource_ref()`
	)

将列表列同一行中的多个列表串联成一个单独的列表。

给定一个列表列，其中该列的每一行都是一个包含条目列表的列表，通过将同一行的所有列表元素串联起来生成一个输出列表列。如果任何行包含空列表元素，串联过程将忽略这些空元素，或者简单地将整个结果行设置为空元素。

l = [ [{1, 2}, {3, 4}, {5}], [{6}, {}, {7, 8, 9}] ]
r = lists::concatenate_list_elements(l);
r 是 [ {1, 2, 3, 4, 5}, {6, 7, 8, 9} ]

异常

std::invalid_argument 如果输入列不是至少两层深度的列表列（即，每一行必须是一个列表的列表）。

参数

输入	包含要串联的列表元素的列表的列表列。
空值策略	用于指定是否忽略串联中的空列表元素，或者任何涉及空元素的串联将导致空列表的参数。
流	用于设备内存操作和内核启动的 CUDA 流。
mr	用于分配返回列的设备内存的设备内存资源。

返回: 一个新的列，其中每一行都是将输入列表列对应行中的所有列表元素串联后的结果列表。

◆ concatenate_rows()

std::unique_ptr<列> cudf::lists::concatenate_rows	(	表视图 const &	输入,
		concatenate_null_policy	空值策略 = `concatenate_null_policy::IGNORE`,
		rmm::cuda_stream_view	流 = `cudf::get_default_stream()`,
		rmm::device_async_resource_ref	mr = `cudf::get_current_device_resource_ref()`
	)

按行串联多个列表列到一个单独的列表列中。

输出列是通过串联输入表中每行内的元素生成的。如果输入表的任何行包含空元素，串联过程将忽略这些空元素，或者简单地将整个结果行设置为空元素。

s1 = [{0, 1}, {2, 3, 4}, {5}, {}, {6, 7}]
s2 = [{8}, {9}, {}, {10, 11, 12}, {13, 14, 15, 16}]
r = lists::concatenate_rows(s1, s2)
r 现在是 [{0, 1, 8}, {2, 3, 4, 9}, {5}, {10, 11, 12}, {6, 7, 13, 14, 15, 16}]