scalar_factories.hpp
转到此文件的文档。
1 /*
2  * Copyright (c) 2019-2024, NVIDIA CORPORATION.
3  *
4  * 根据 Apache 许可证第 2.0 版(“许可证”)获得许可;
5  * 除非遵守许可证,否则您不得使用此文件。
6  * 您可以获取许可证的副本,网址为
7  *
8  * https://apache.ac.cn/licenses/LICENSE-2.0
9  *
10  * 除非适用法律要求或书面同意,
11  * 根据许可证分发的软件按“原样”分发,
12  * 不附带任何明示或暗示的保证或条件。
13  * 有关特定语言的权限和
14  * 许可证下的限制,请参阅许可证。
15  */
16 #pragma once
17 
18 #include <cudf/scalar/scalar.hpp>
21 
22 #include <rmm/cuda_stream_view.hpp>
23 
24 namespace CUDF_EXPORT cudf {
44 std::unique_ptr<scalar> make_numeric_scalar(
45  data_type type,
48 
61 std::unique_ptr<scalar> make_timestamp_scalar(
62  data_type type,
65 
78 std::unique_ptr<scalar> make_duration_scalar(
79  data_type type,
82 
95 std::unique_ptr<scalar> make_fixed_width_scalar(
96  data_type type,
99 
112 std::unique_ptr<scalar> make_string_scalar(
113  std::string const& string,
116 
127 std::unique_ptr<scalar> make_default_constructed_scalar(
128  data_type type,
131 
142 std::unique_ptr<scalar> make_empty_scalar_like(
143  column_view const& input,
146 
156 template <typename T>
157 std::unique_ptr<scalar> make_fixed_width_scalar(
158  T value,
161 {
162  return std::make_unique<scalar_type_t<T>>(value, true, stream, mr);
163 }
164 
175 template <typename T>
176 std::unique_ptr<scalar> make_fixed_point_scalar(
177  typename T::rep value,
178  numeric::scale_type scale,
181 {
182  return std::make_unique<scalar_type_t<T>>(value, scale, true, stream, mr);
183 }
184 
193 std::unique_ptr<scalar> make_list_scalar(
194  column_view elements,
197 
208 std::unique_ptr<scalar> make_struct_scalar(
209  table_view const& data,
212 
223 std::unique_ptr<scalar> make_struct_scalar(
227  // 组结束
229 } // namespace CUDF_EXPORT cudf
作为元素列的设备数据的非拥有、不可变视图,其中一些元素可能为 null,具体取决于...
列中元素逻辑数据类型的指示符。
定义: types.hpp:243
一组大小相同的 cudf::column_view。
rmm::cuda_stream_view const get_default_stream()
获取当前默认流。
scale_type
fixed_point 的比例类型。
rmm::device_async_resource_ref get_current_device_resource_ref()
获取当前设备内存资源引用。
cuda::mr::async_resource_ref< cuda::mr::device_accessible > device_async_resource_ref
std::unique_ptr< scalar > 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())
构造带有未初始化存储的标量,用于存储指定 duration 数据类型的值。
std::unique_ptr< scalar > 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())
使用给定 fixed_point 类型值构造标量。
std::unique_ptr< scalar > 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< scalar > 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())
创建与输入 column_view 类型相同的空(无效)标量。
std::unique_ptr< scalar > 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())
构造带有未初始化存储的标量,用于存储指定 numeric 数据类型的值。
std::unique_ptr< scalar > 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())
使用给定的 column views span 构造 struct 标量。
std::unique_ptr< scalar > 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())
使用给定 fixed width 类型值构造标量。
std::unique_ptr< scalar > 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())
构造 default constructed 的 type 类型标量。
std::unique_ptr< scalar > 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 的大小不能超过最大值...
std::unique_ptr< scalar > 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())
构造带有未初始化存储的标量,用于存储指定 timestamp 数据类型的值。
cuDF 接口
定义: host_udf.hpp:37
cudf::scalar 的类定义。
带有简化功能集的 C++20 std::span。
定义: span.hpp:194