find.hpp
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2019-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
3  * SPDX-License-Identifier: Apache-2.0
4  */
5 #pragma once
6 
7 #include <cudf/column/column.hpp>
8 #include <cudf/scalar/scalar.hpp>
9 #include <cudf/strings/strings_column_view.hpp>
10 #include <cudf/utilities/memory_resource.hpp>
11 
17 namespace CUDF_EXPORT cudf {
18 namespace strings {
47 std::unique_ptr<column> find(
48  strings_column_view const& input,
49  string_scalar const& target,
50  size_type start = 0,
51  size_type stop = -1,
52  rmm::cuda_stream_view stream = cudf::get_default_stream(),
53  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
54 
78 std::unique_ptr<column> rfind(
79  strings_column_view const& input,
80  string_scalar const& target,
81  size_type start = 0,
82  size_type stop = -1,
83  rmm::cuda_stream_view stream = cudf::get_default_stream(),
84  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
85 
106 std::unique_ptr<column> find(
107  strings_column_view const& input,
108  strings_column_view const& target,
109  size_type start = 0,
110  rmm::cuda_stream_view stream = cudf::get_default_stream(),
111  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
112 
139 std::unique_ptr<column> find_instance(
140  strings_column_view const& input,
141  string_scalar const& target,
142  size_type instance = 0,
143  rmm::cuda_stream_view stream = cudf::get_default_stream(),
144  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
145 
161 std::unique_ptr<column> contains(
162  strings_column_view const& input,
163  string_scalar const& target,
164  rmm::cuda_stream_view stream = cudf::get_default_stream(),
165  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
166 
186 std::unique_ptr<column> contains(
187  strings_column_view const& input,
188  strings_column_view const& targets,
189  rmm::cuda_stream_view stream = cudf::get_default_stream(),
190  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
191 
208 std::unique_ptr<column> starts_with(
209  strings_column_view const& input,
210  string_scalar const& target,
211  rmm::cuda_stream_view stream = cudf::get_default_stream(),
212  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
213 
234 std::unique_ptr<column> starts_with(
235  strings_column_view const& input,
236  strings_column_view const& targets,
237  rmm::cuda_stream_view stream = cudf::get_default_stream(),
238  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
239 
256 std::unique_ptr<column> ends_with(
257  strings_column_view const& input,
258  string_scalar const& target,
259  rmm::cuda_stream_view stream = cudf::get_default_stream(),
260  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
261 
282 std::unique_ptr<column> ends_with(
283  strings_column_view const& input,
284  strings_column_view const& targets,
285  rmm::cuda_stream_view stream = cudf::get_default_stream(),
286  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
287 
310 std::unique_ptr<column> count(
311  strings_column_view const& input,
312  string_scalar const& target,
313  rmm::cuda_stream_view stream = cudf::get_default_stream(),
314  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
315  // end of doxygen group
317 } // namespace strings
318 } // namespace CUDF_EXPORT cudf
cudf::string_scalar
An owning class to represent a string in device memory.
Definition: scalar.hpp:411
cudf::strings_column_view
Given a column-view of strings type, an instance of this class provides a wrapper on this compound co...
Definition: strings_column_view.hpp:27
rmm::cuda_stream_view
column.hpp
Class definition for cudf::column.
cudf::get_default_stream
rmm::cuda_stream_view const get_default_stream()
Get the current default stream.
cudf::get_current_device_resource_ref
rmm::device_async_resource_ref get_current_device_resource_ref()
Get the current device memory resource reference.
Definition: memory_resource.hpp:34
rmm::device_async_resource_ref
cuda::mr::resource_ref< cuda::mr::device_accessible > device_async_resource_ref
cudf::strings::find
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...
cudf::strings::find_instance
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...
cudf::strings::count
std::unique_ptr< column > count(strings_column_view const &input, string_scalar const &target, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::device_async_resource_ref mr=cudf::get_current_device_resource_ref())
Returns the number of times the given target string matches in each string.
cudf::strings::rfind
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...
cudf::strings::starts_with
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...
cudf::strings::contains
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...
cudf::strings::ends_with
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...
cudf::size_type
int32_t size_type
Row index type for columns and tables.
Definition: types.hpp:84
memory_resource.hpp
APIs for getting and setting the current device memory resource.
cudf
cuDF interfaces
Definition: host_udf.hpp:26
scalar.hpp
Class definitions for cudf::scalar.
strings_column_view.hpp
Class definition for cudf::strings_column_view.
Generated by doxygen 1.9.1