Searching

Functions
std::unique_ptr< scalar >	cudf::dictionary::get_index (dictionary_column_view const &dictionary, scalar const &key, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	Return the index value for a given key. More...

Detailed Description

Function Documentation

get_index()

std::unique_ptr<scalar> cudf::dictionary::get_index	(	dictionary_column_view const &	dictionary,
		scalar const &	key,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

#include <cudf/dictionary/search.hpp>

Return the index value for a given key.

If the key does not exist in the dictionary the returned scalar will have is_valid()==false.

Exceptions

std::invalid_argument

if key.type() != dictionary.keys().type() or dictionary is empty.

Parameters

dictionary	The dictionary to search for the key
key	The value to search for in the dictionary keyset
stream	CUDA stream used for device memory operations and kernel launches
mr	Device memory resource used to allocate the returned scalar's device memory

Returns

Numeric scalar index value of the key within the dictionary