find.hpp
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2019-2025, NVIDIA CORPORATION.
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 
12 namespace CUDF_EXPORT cudf {
13 namespace strings {
43 std::unique_ptr<column> find(
44  strings_column_view const& input,
45  string_scalar const& target,
46  size_type start = 0,
47  size_type stop = -1,
48  rmm::cuda_stream_view stream = cudf::get_default_stream(),
49  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
50 
74 std::unique_ptr<column> rfind(
75  strings_column_view const& input,
76  string_scalar const& target,
77  size_type start = 0,
78  size_type stop = -1,
79  rmm::cuda_stream_view stream = cudf::get_default_stream(),
80  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
81 
102 std::unique_ptr<column> find(
103  strings_column_view const& input,
104  strings_column_view const& target,
105  size_type start = 0,
106  rmm::cuda_stream_view stream = cudf::get_default_stream(),
107  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
108 
135 std::unique_ptr<column> find_instance(
136  strings_column_view const& input,
137  string_scalar const& target,
138  size_type instance = 0,
139  rmm::cuda_stream_view stream = cudf::get_default_stream(),
140  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
141 
157 std::unique_ptr<column> contains(
158  strings_column_view const& input,
159  string_scalar const& target,
160  rmm::cuda_stream_view stream = cudf::get_default_stream(),
161  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
162 
182 std::unique_ptr<column> contains(
183  strings_column_view const& input,
184  strings_column_view const& targets,
185  rmm::cuda_stream_view stream = cudf::get_default_stream(),
186  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
187 
204 std::unique_ptr<column> starts_with(
205  strings_column_view const& input,
206  string_scalar const& target,
207  rmm::cuda_stream_view stream = cudf::get_default_stream(),
208  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
209 
230 std::unique_ptr<column> starts_with(
231  strings_column_view const& input,
232  strings_column_view const& targets,
233  rmm::cuda_stream_view stream = cudf::get_default_stream(),
234  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
235 
252 std::unique_ptr<column> ends_with(
253  strings_column_view const& input,
254  string_scalar const& target,
255  rmm::cuda_stream_view stream = cudf::get_default_stream(),
256  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref());
257 
278 std::unique_ptr<column> ends_with(
279  strings_column_view const& input,
280  strings_column_view const& targets,
281  rmm::cuda_stream_view stream = cudf::get_default_stream(),
282  rmm::device_async_resource_ref mr = cudf::get_current_device_resource_ref()); // end of doxygen group
284 } // namespace strings
285 } // namespace CUDF_EXPORT cudf
cudf::string_scalar
An owning class to represent a string in device memory.
Definition: scalar.hpp:410
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:40
device_async_resource_ref
detail::cccl_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::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
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