搜索

文件
文件	lists/contains.hpp

枚举
枚举类	cudf::lists::duplicate_find_option : int32_t { cudf::lists::FIND_FIRST = 0 , cudf::lists::FIND_LAST }
	用于选择 index_of() 返回搜索键在列表行中的第一个匹配项还是最后一个匹配项的选项。 更多...

函数
std::unique_ptr< column >	cudf::lists::contains (cudf::lists_column_view const &lists, cudf::scalar const &search_key, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个 bool 值列，指示指定的标量是否是列表列每行的元素。 更多...
std::unique_ptr< column >	cudf::lists::contains (cudf::lists_column_view const &lists, cudf::column_view const &search_keys, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个 bool 值列，指示第一列的列表行是否包含第二列中的对应值。 更多...
std::unique_ptr< column >	cudf::lists::contains_nulls (cudf::lists_column_view const &lists, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个 bool 值列，指示 lists 列中的每一行是否至少包含一个空元素。 更多...
std::unique_ptr< column >	cudf::lists::index_of (cudf::lists_column_view const &lists, cudf::scalar const &search_key, duplicate_find_option find_option=duplicate_find_option::FIND_FIRST, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个值列，指示搜索键在 lists 列的每个列表行中的位置。 更多...
std::unique_ptr< column >	cudf::lists::index_of (cudf::lists_column_view const &lists, cudf::column_view const &search_keys, duplicate_find_option find_option=duplicate_find_option::FIND_FIRST, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个值列，指示搜索键行在 lists 列的相应列表行中的位置。 更多...

详细描述

枚举类型文档

duplicate_find_option

enum cudf::lists::duplicate_find_option : int32_t

强

用于选择 index_of() 返回搜索键在列表行中的第一个匹配项还是最后一个匹配项的选项。

枚举成员
FIND_FIRST	查找搜索键在列表行中的第一个实例。
FIND_LAST	查找搜索键在列表行中的最后一个实例。

定义在文件 lists/contains.hpp 的行 105。

函数文档

contains() [1/2]

std::unique_ptr<column> cudf::lists::contains	(	cudf::lists_column_view const &	lists,
		cudf::column_view const &	search_keys,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个 bool 值列，指示第一列的列表行是否包含第二列中的对应值。

输出列的元素数量与输入 lists 列相同。如果列表行 lists[i] 包含 search_keys[i] 中的值，则输出 column[i] 设置为 true，否则设置为 false。

如果满足以下一个或多个条件，则输出 column[i] 设置为 null：

1. 行 search_keys[i] 为 null
2. 列表行 lists[i] 为 null

参数

lists	要搜索其 n 行的列表列
search_keys	要在每个列表行中查找的元素列。
stream	用于设备内存操作和内核启动的 CUDA 流。
mr	用于分配返回列的设备内存的设备内存资源

返回值

具有查找结果的 n 行的 BOOL8 列

contains() [2/2]

std::unique_ptr<column> cudf::lists::contains	(	cudf::lists_column_view const &	lists,
		cudf::scalar const &	search_key,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个 bool 值列，指示指定的标量是否是列表列每行的元素。

输出列的元素数量与输入 lists 列相同。如果列表行 lists[i] 包含 search_key 中指定的值，则输出 column[i] 设置为 true，否则设置为 false。

如果满足以下一个或多个条件，则输出 column[i] 设置为 null：

1. 搜索键 search_key 为 null
2. 列表行 lists[i] 为 null

参数

lists	要搜索其 n 行的列表列
search_key	要在每个列表行中查找的标量键
stream	用于设备内存操作和内核启动的 CUDA 流。
mr	用于分配返回列的设备内存的设备内存资源

返回值

具有查找结果的 n 行的 BOOL8 列

contains_nulls()

std::unique_ptr<column> cudf::lists::contains_nulls	(	cudf::lists_column_view const &	lists,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个 bool 值列，指示 lists 列中的每一行是否至少包含一个空元素。

输出列的元素数量与输入 lists 列相同。如果行 lists[i] 为 null，则输出 column[i] 设置为 null。否则，column[i] 设置为非 null 布尔值，具体取决于该列表是否包含 null 元素。

空列表的行始终返回 false。非空嵌套元素（例如列表或结构）中的 null 不会被考虑。

参数

lists	要搜索其 n 行的列表列。
stream	用于设备内存操作和内核启动的 CUDA 流。
mr	用于分配返回列的设备内存的设备内存资源

返回值

具有查找结果的 n 行的 BOOL8 列

index_of() [1/2]

std::unique_ptr<column> cudf::lists::index_of	(	cudf::lists_column_view const &	lists,
		cudf::column_view const &	search_keys,
		duplicate_find_option	find_option = duplicate_find_option::FIND_FIRST,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个值列，指示搜索键行在 lists 列的相应列表行中的位置。

输出列的元素数量与输入 lists 列中的行数相同。输出 column[i] 包含一个从 0 开始的索引，指示每个搜索键行在其对应列表行中的位置，从列表开头算起。注意

1. 如果 search_keys[i] 为 null，则 output[i] 也为 null。
2. 如果行 lists[i] 为 null，则 output[i] 也为 null。
3. 如果行 lists[i] 不包含 search_key[i]，则 output[i] 设置为 -1。
4. 在所有其他情况下，output[i] 设置为非负的 size_type 索引。

如果 find_option 设置为 FIND_FIRST，则返回 search_key 的第一个匹配项的位置。如果 find_option == FIND_LAST，则返回列表行中最后一个匹配项的位置。

异常

cudf::logic_error	如果 search_keys 的行数与 lists 不匹配
cudf::data_type_error	如果 search_keys 的类型与 lists 中的元素类型不匹配

参数

lists	要搜索其 n 行的列表列
search_keys	要在 lists 的每个对应行中查找的搜索键列
find_option	返回第一个匹配项（FIND_FIRST）还是最后一个（FIND_LAST）的位置
stream	用于设备内存操作和内核启动的 CUDA 流
mr	用于分配返回列的设备内存的设备内存资源

返回值

具有 search_key 位置的 n 行列

index_of() [2/2]

std::unique_ptr<column> cudf::lists::index_of	(	cudf::lists_column_view const &	lists,
		cudf::scalar const &	search_key,
		duplicate_find_option	find_option = duplicate_find_option::FIND_FIRST,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个值列，指示搜索键在 lists 列的每个列表行中的位置。

输出列的元素数量与输入 lists 列中的行数相同。输出 column[i] 包含一个从 0 开始的索引，指示搜索键在每个列表中的位置，从列表开头算起。注意

1. 如果 search_key 为 null，则所有输出行都设置为 null。
2. 如果行 lists[i] 为 null，则 output[i] 也为 null。
3. 如果行 lists[i] 不包含 search_key，则 output[i] 设置为 -1。
4. 在所有其他情况下，output[i] 设置为非负的 size_type 索引。

如果 find_option 设置为 FIND_FIRST，则返回 search_key 的第一个匹配项的位置。如果 find_option == FIND_LAST，则返回列表行中最后一个匹配项的位置。

异常

cudf::data_type_error

如果 search_keys 的类型与 lists 中的元素类型不匹配

参数

lists	要搜索其 n 行的列表列
search_key	要在每个列表行中查找的标量键
find_option	返回第一个匹配项（FIND_FIRST）还是最后一个（FIND_LAST）的位置
stream	用于设备内存操作和内核启动的 CUDA 流
mr	用于分配返回列的设备内存的设备内存资源

返回值

具有 search_key 位置的 n 行列