find.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>
21 
22 #include <rmm/mr/device/per_device_resource.hpp>
23 #include <rmm/resource_ref.hpp>
24 
25 namespace cudf {
26 namespace strings {
56 std::unique_ptr<column> find(
57  strings_column_view const& input,
58  string_scalar const& target,
59  size_type start = 0,
60  size_type stop = -1,
61  rmm::cuda_stream_view stream = cudf::get_default_stream(),
62  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
63 
87 std::unique_ptr<column> rfind(
88  strings_column_view const& input,
89  string_scalar const& target,
90  size_type start = 0,
91  size_type stop = -1,
92  rmm::cuda_stream_view stream = cudf::get_default_stream(),
93  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
94 
115 std::unique_ptr<column> find(
116  strings_column_view const& input,
117  strings_column_view const& target,
118  size_type start = 0,
119  rmm::cuda_stream_view stream = cudf::get_default_stream(),
120  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
121 
137 std::unique_ptr<column> contains(
138  strings_column_view const& input,
139  string_scalar const& target,
140  rmm::cuda_stream_view stream = cudf::get_default_stream(),
141  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
142 
162 std::unique_ptr<column> contains(
163  strings_column_view const& input,
164  strings_column_view const& targets,
165  rmm::cuda_stream_view stream = cudf::get_default_stream(),
166  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
167 
184 std::unique_ptr<column> starts_with(
185  strings_column_view const& input,
186  string_scalar const& target,
187  rmm::cuda_stream_view stream = cudf::get_default_stream(),
188  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
189 
210 std::unique_ptr<column> starts_with(
211  strings_column_view const& input,
212  strings_column_view const& targets,
213  rmm::cuda_stream_view stream = cudf::get_default_stream(),
214  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
215 
232 std::unique_ptr<column> ends_with(
233  strings_column_view const& input,
234  string_scalar const& target,
235  rmm::cuda_stream_view stream = cudf::get_default_stream(),
236  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
237 
258 std::unique_ptr<column> ends_with(
259  strings_column_view const& input,
260  strings_column_view const& targets,
261  rmm::cuda_stream_view stream = cudf::get_default_stream(),
262  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource()); // end of doxygen group
264 } // namespace strings
265 } // namespace cudf
An owning class to represent a string in device memory.
Definition: scalar.hpp:430
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.
std::unique_ptr< column > contains(strings_column_view const &input, string_scalar const &target, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=rmm::mr::get_current_device_resource())
Returns a column of boolean values for each string where true indicates the target string was found w...
std::unique_ptr< column > find(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=rmm::mr::get_current_device_resource())
Returns a column of character position values where the target string is first found in each string o...
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=rmm::mr::get_current_device_resource())
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, string_scalar const &target, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=rmm::mr::get_current_device_resource())
Returns a column of boolean values for each string where true indicates the target string was found a...
std::unique_ptr< column > ends_with(strings_column_view const &input, string_scalar const &target, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=rmm::mr::get_current_device_resource())
Returns a column of boolean values for each string where true indicates the target string was found a...
int32_t size_type
Row index type for columns and tables.
Definition: types.hpp:93
cuDF interfaces
Definition: aggregation.hpp:34
Class definitions for cudf::scalar.
Class definition for cudf::strings_column_view.