Deprecate libcudf regex APIs accepting pattern strings directly

[davidwendt]

Description

Deprecates the libcudf regex APIs that do not accept cudf::strings::regex_program objects.
The libcudf regex functions were converted to accept regex_program objects instead of a pattern string and regex-flags directly in PR #11927
Most of this is removing calls to the deprecated functions in the gtests.
The declarations in the headers had to be reordered to make the reference links work in the doxygen output.

These deprecated functions will be removed in a future release.

Checklist

• I am familiar with the Contributing Guidelines.
• New or existing tests cover these changes.
• The documentation is up to date with these changes.

[davidwendt]

Apologize for reordering the declarations in the headers to make doxygen work. They headers look difficult to review now. Essentially there are two APIs one with string_view pattern parameter and one with regex_program parameter. The order of these were swapped in the header file at each location so the regex_program one would appear before the string_view one.

[vuule]

Do you have a timeline to remove the deprecated APIs?
I'm wondering if we should add deprecation warning message(s) once logger is in place, so deprecation is more visible.

[davidwendt]

Do you have a timeline to remove the deprecated APIs?

I was planning to remove them in 23.06.

I'm wondering if we should add deprecation warning message(s) once logger is in place, so deprecation is more visible.

The compiler will give a deprecation warning. I'm not sure we should warn actual end users.

[vuule]

Oh, right, [[deprecated]]. Yeah, that sounds perfect.

[vuule]

doxygen really spiced this one up :D

[davidwendt]

/merge