工厂

文件
文件	scalar_factories.hpp
	标量工厂 API。

函数
std::unique_ptr< 标量 >	cudf::make_numeric_scalar (data_type type, 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::make_timestamp_scalar (data_type type, 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::make_duration_scalar (data_type type, 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::make_fixed_width_scalar (data_type type, 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::make_string_scalar (std::string const &string, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	构造给定 std::string 的 STRING 类型标量。 std::string 的大小不得超过 size_type 的最大大小。字符串字符预计为 UTF-8 编码的 char 字节序列。 更多...
std::unique_ptr< 标量 >	cudf::make_default_constructed_scalar (data_type type, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	构造类型为 type 的默认构造标量 更多...
std::unique_ptr< 标量 >	cudf::make_empty_scalar_like (column_view const &input, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	创建一个与 input column_view 类型相同的空（无效）标量。 更多...
template<typename T >
std::unique_ptr< 标量 >	cudf::make_fixed_width_scalar (T value, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	使用给定固定宽度类型的值构造标量。 更多...
template<typename T >
std::unique_ptr< 标量 >	cudf::make_fixed_point_scalar (typename T::rep value, numeric::scale_type scale, 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::make_list_scalar (column_view elements, 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::make_struct_scalar (table_view const &data, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	使用给定的 table_view 构造结构体标量。 更多...
std::unique_ptr< 标量 >	cudf::make_struct_scalar (host_span< column_view const > data, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
	使用给定的列视图范围构造结构体标量。 更多...

详细描述

函数文档

make_default_constructed_scalar()

std::unique_ptr<标量> cudf::make_default_constructed_scalar	(	数据类型	类型,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

构造类型为 type 的默认构造标量

异常

std::bad_alloc

如果设备内存分配失败

参数

类型	所需的元素类型
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

类型为 type 的标量

make_duration_scalar()

std::unique_ptr<标量> cudf::make_duration_scalar	(	数据类型	类型,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

构造具有未初始化存储的标量，用于存放指定时长 数据类型 的值。

异常

std::bad_alloc	如果设备内存分配失败
cudf::logic_error	如果 type 不是时长类型

参数

类型	所需的时长元素类型
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个未初始化的时长标量

make_empty_scalar_like()

std::unique_ptr<标量> cudf::make_empty_scalar_like	(	column_view const &	input,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

创建一个与 input column_view 类型相同的空（无效）标量。

异常

cudf::logic_error

如果 input 列是结构体类型且为空

参数

input	要模拟的输入列的不可变视图
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

与 input 列类型相同的标量

make_fixed_point_scalar()

template<typename T >

std::unique_ptr<标量> cudf::make_fixed_point_scalar	(	typename T::rep	value,
		numeric::scale_type	scale,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

使用给定定点类型的值构造标量。

模板参数

T	要由标量表示的值的数据类型

参数

value	要存储在标量对象中的值
scale	定点值的刻度
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

类型为 T 的标量

定义于文件 scalar_factories.hpp 的 176 行。

make_fixed_width_scalar() [1/2]

std::unique_ptr<标量> cudf::make_fixed_width_scalar	(	数据类型	类型,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

构造具有未初始化存储的标量，用于存放指定固定宽度 数据类型 的值。

异常

std::bad_alloc	如果设备内存分配失败
cudf::logic_error	如果 type 不是固定宽度类型

参数

类型	所需的固定宽度元素类型
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个未初始化的固定宽度标量

make_fixed_width_scalar() [2/2]

template<typename T >

std::unique_ptr<标量> cudf::make_fixed_width_scalar	(	T	value,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

使用给定固定宽度类型的值构造标量。

模板参数

T	要由标量表示的值的数据类型

参数

value	要存储在标量对象中的值
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

类型为 T 的标量

定义于文件 scalar_factories.hpp 的 157 行。

make_list_scalar()

std::unique_ptr<标量> cudf::make_list_scalar	(	column_view	elements,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

使用给定的元素列构造标量。

参数

elements	列表的元素
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个列表标量

make_numeric_scalar()

std::unique_ptr<标量> cudf::make_numeric_scalar	(	数据类型	类型,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

构造具有未初始化存储的标量，用于存放指定数值 数据类型 的值。

异常

std::bad_alloc	如果设备内存分配失败
cudf::logic_error	如果 type 不是数值类型

参数

类型	所需的数值元素类型
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个未初始化的数值标量

make_string_scalar()

std::unique_ptr<标量> cudf::make_string_scalar	(	std::string const &	string,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

构造给定 std::string 的 STRING 类型标量。 std::string 的大小不得超过 size_type 的最大大小。字符串字符预计为 UTF-8 编码的 char 字节序列。

异常

std::bad_alloc

如果设备内存分配失败

参数

string	要复制到设备的 std::string
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

包含 string 内容的字符串标量

make_struct_scalar() [1/2]

std::unique_ptr<标量> cudf::make_struct_scalar	(	host_span< column_view const >	data,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

使用给定的列视图范围构造结构体标量。

这些列必须有 1 行。

参数

data	要存储在标量对象中的列式数据
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个结构体标量

make_struct_scalar() [2/2]

std::unique_ptr<标量> cudf::make_struct_scalar	(	table_view const &	data,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

使用给定的 table_view 构造结构体标量。

这些列必须有 1 行。

参数

data	要存储在标量对象中的列式数据
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个结构体标量

make_timestamp_scalar()

std::unique_ptr<标量> cudf::make_timestamp_scalar	(	数据类型	类型,
		rmm::cuda_stream_view	stream = cudf::get_default_stream(),
		rmm::device_async_resource_ref	mr = cudf::get_current_device_resource_ref()
	)

构造具有未初始化存储的标量，用于存放指定时间戳 数据类型 的值。

异常

std::bad_alloc	如果设备内存分配失败
cudf::logic_error	如果 type 不是时间戳类型

参数

类型	所需的时间戳元素类型
stream	用于设备内存操作的 CUDA 流。
mr	用于分配标量 data 和 is_valid 布尔值的设备内存资源。

返回

一个未初始化的时间戳标量