Factories

Files
file	scalar_factories.hpp
	Scalar factory APIs.

Functions
std::unique_ptr< scalar >	cudf::make_numeric_scalar (data_type type, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct scalar with uninitialized storage to hold a value of the specified numeric data_type. More...
std::unique_ptr< scalar >	cudf::make_timestamp_scalar (data_type type, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct scalar with uninitialized storage to hold a value of the specified timestamp data_type. More...
std::unique_ptr< scalar >	cudf::make_duration_scalar (data_type type, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct scalar with uninitialized storage to hold a value of the specified duration data_type. More...
std::unique_ptr< scalar >	cudf::make_fixed_width_scalar (data_type type, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct scalar with uninitialized storage to hold a value of the specified fixed-width data_type. More...
std::unique_ptr< scalar >	cudf::make_string_scalar (std::string const &string, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct STRING type scalar given a std::string. The size of the std::string must not exceed the maximum size of size_type. The string characters are expected to be UTF-8 encoded sequence of char bytes. More...
std::unique_ptr< scalar >	cudf::make_default_constructed_scalar (data_type type, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Constructs default constructed scalar of type type More...
template<typename T >
std::unique_ptr< scalar >	cudf::make_fixed_width_scalar (T value, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct scalar using the given value of fixed width type. More...
template<typename T >
std::unique_ptr< scalar >	cudf::make_fixed_point_scalar (typename T::rep value, numeric::scale_type scale, rmm::cuda_stream_view stream=rmm::cuda_stream_default, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
	Construct scalar using the given value of fixed_point type. More...

Detailed Description

Function Documentation

make_default_constructed_scalar()

std::unique_ptr<scalar> cudf::make_default_constructed_scalar	(	data_type	type,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Constructs default constructed scalar of type type

Exceptions

std::bad_alloc

if device memory allocation fails

Parameters

type	The desired element type
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

make_duration_scalar()

std::unique_ptr<scalar> cudf::make_duration_scalar	(	data_type	type,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct scalar with uninitialized storage to hold a value of the specified duration data_type.

Exceptions

std::bad_alloc	if device memory allocation fails
cudf::logic_error	if type is not a duration type

Parameters

type	The desired duration element type
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

make_fixed_point_scalar()

template<typename T >

std::unique_ptr<scalar> cudf::make_fixed_point_scalar	(	typename T::rep	value,
		numeric::scale_type	scale,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct scalar using the given value of fixed_point type.

Template Parameters

T	Datatype of the value to be represented by the scalar

Parameters

value	The value to store in the scalar object
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

Definition at line 150 of file scalar_factories.hpp.

make_fixed_width_scalar() [1/2]

std::unique_ptr<scalar> cudf::make_fixed_width_scalar	(	data_type	type,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct scalar with uninitialized storage to hold a value of the specified fixed-width data_type.

Exceptions

std::bad_alloc	if device memory allocation fails
cudf::logic_error	if type is not a fixed-width type

Parameters

type	The desired fixed-width element type
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

make_fixed_width_scalar() [2/2]

template<typename T >

std::unique_ptr<scalar> cudf::make_fixed_width_scalar	(	T	value,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct scalar using the given value of fixed width type.

Template Parameters

T	Datatype of the value to be represented by the scalar

Parameters

value	The value to store in the scalar object
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

Definition at line 133 of file scalar_factories.hpp.

make_numeric_scalar()

std::unique_ptr<scalar> cudf::make_numeric_scalar	(	data_type	type,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct scalar with uninitialized storage to hold a value of the specified numeric data_type.

Exceptions

std::bad_alloc	if device memory allocation fails
cudf::logic_error	if type is not a numeric type

Parameters

type	The desired numeric element type
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

make_string_scalar()

std::unique_ptr<scalar> cudf::make_string_scalar	(	std::string const &	string,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct STRING type scalar given a std::string. The size of the std::string must not exceed the maximum size of size_type. The string characters are expected to be UTF-8 encoded sequence of char bytes.

Exceptions

std::bad_alloc

if device memory allocation fails

Parameters

string	The std::string to copy to device
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.

make_timestamp_scalar()

std::unique_ptr<scalar> cudf::make_timestamp_scalar	(	data_type	type,
		rmm::cuda_stream_view	stream = rmm::cuda_stream_default,
		rmm::mr::device_memory_resource *	mr = rmm::mr::get_current_device_resource()
	)

Construct scalar with uninitialized storage to hold a value of the specified timestamp data_type.

Exceptions

std::bad_alloc	if device memory allocation fails
cudf::logic_error	if type is not a timestamp type

Parameters

type	The desired timestamp element type
stream	CUDA stream used for device memory operations.
mr	Device memory resource used to allocate the scalar's data and is_valid bool.