find.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019-2025, 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>
22 
23 namespace CUDF_EXPORT cudf {
24 namespace strings {
54 std::unique_ptr<column> find(
55  strings_column_view const& input,
56  string_scalar const& target,
57  size_type start = 0,
58  size_type stop = -1,
61 
85 std::unique_ptr<column> rfind(
86  strings_column_view const& input,
87  string_scalar const& target,
88  size_type start = 0,
89  size_type stop = -1,
92 
113 std::unique_ptr<column> find(
114  strings_column_view const& input,
115  strings_column_view const& target,
116  size_type start = 0,
119 
146 std::unique_ptr<column> find_instance(
147  strings_column_view const& input,
148  string_scalar const& target,
149  size_type instance = 0,
152 
168 std::unique_ptr<column> contains(
169  strings_column_view const& input,
170  string_scalar const& target,
173 
193 std::unique_ptr<column> contains(
194  strings_column_view const& input,
195  strings_column_view const& targets,
198 
215 std::unique_ptr<column> starts_with(
216  strings_column_view const& input,
217  string_scalar const& target,
220 
241 std::unique_ptr<column> starts_with(
242  strings_column_view const& input,
243  strings_column_view const& targets,
246 
263 std::unique_ptr<column> ends_with(
264  strings_column_view const& input,
265  string_scalar const& target,
268 
289 std::unique_ptr<column> ends_with(
290  strings_column_view const& input,
291  strings_column_view const& targets,
295 } // namespace strings
296 } // namespace CUDF_EXPORT cudf
An owning class to represent a string in device memory.
Definition: scalar.hpp:421
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 > find(strings_column_view const &input, strings_column_view const &target, size_type start=0, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns a column of character position values where the target string is first found in the correspon...
std::unique_ptr< column > find_instance(strings_column_view const &input, string_scalar const &target, size_type instance=0, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns a column of character position values where the index-th target string is found in each strin...
std::unique_ptr< column > rfind(strings_column_view const &input, string_scalar const &target, size_type start=0, size_type stop=-1, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns a column of character position values where the target string is first found searching from t...
std::unique_ptr< column > starts_with(strings_column_view const &input, strings_column_view const &targets, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns a column of boolean values for each string where true indicates corresponding string in targe...
std::unique_ptr< column > contains(strings_column_view const &input, strings_column_view const &targets, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns a column of boolean values for each string where true indicates the corresponding target stri...
std::unique_ptr< column > ends_with(strings_column_view const &input, strings_column_view const &targets, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns a column of boolean values for each string where true indicates corresponding string in targe...
int32_t size_type
Row index type for columns and tables.
Definition: types.hpp:95
cuDF interfaces
Definition: host_udf.hpp:37
Class definitions for cudf::scalar.
Class definition for cudf::strings_column_view.