translate.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019-2024, NVIDIA CORPORATION.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 #pragma once
17 
18 #include <cudf/column/column.hpp>
19 #include <cudf/scalar/scalar.hpp>
23 
24 #include <vector>
25 
26 namespace CUDF_EXPORT cudf {
27 namespace strings {
55 std::unique_ptr<column> translate(
56  strings_column_view const& input,
57  std::vector<std::pair<char_utf8, char_utf8>> const& chars_table,
60 
64 enum class filter_type : bool {
65  KEEP,
66  REMOVE
67 };
68 
100 std::unique_ptr<column> filter_characters(
101  strings_column_view const& input,
102  std::vector<std::pair<cudf::char_utf8, cudf::char_utf8>> characters_to_filter,
103  filter_type keep_characters = filter_type::KEEP,
104  string_scalar const& replacement = string_scalar(""),
107  // end of doxygen group
109 } // namespace strings
110 } // namespace CUDF_EXPORT cudf
An owning class to represent a string in device memory.
Definition: scalar.hpp:429
Given a column-view of strings type, an instance of this class provides a wrapper on this compound co...
Class definition for cudf::column.
rmm::cuda_stream_view const get_default_stream()
Get the current default stream.
rmm::device_async_resource_ref get_current_device_resource_ref()
Get the current device memory resource reference.
cuda::mr::async_resource_ref< cuda::mr::device_accessible > device_async_resource_ref
std::unique_ptr< column > filter_characters(strings_column_view const &input, std::vector< std::pair< cudf::char_utf8, cudf::char_utf8 >> characters_to_filter, filter_type keep_characters=filter_type::KEEP, string_scalar const &replacement=string_scalar(""), rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Removes ranges of characters from each string in a strings column.
filter_type
Removes or keeps the specified character ranges in cudf::strings::filter_characters.
Definition: translate.hpp:64
std::unique_ptr< column > translate(strings_column_view const &input, std::vector< std::pair< char_utf8, char_utf8 >> const &chars_table, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Translates individual characters within each string.
@ KEEP
All characters but those specified are removed.
@ REMOVE
Only the specified characters are removed.
cuDF interfaces
Definition: aggregation.hpp:35
Class definitions for cudf::scalar.
Class definition for cudf::string_view.
Class definition for cudf::strings_column_view.