GH-17081: [C++] arrow::stl::TupleRangeFromTable docs incorrect

[thisisnic]

Rationale for this change

The documentation example for TupleRangeFromTable was missing the cast_options and ctx parameters, so it didn't match the actual function signature

What changes are included in this PR?

Add them

Are these changes tested?

No

Are there any user-facing changes?

Better docs

• GitHub Issue: [C++] arrow::stl::TupleRangeFromTable docs incorrect #17081

[github-actions]

⚠️ GitHub issue #17081 has been automatically assigned in GitHub to PR creator.

[Copilot]

Pull request overview

This PR fixes the C++ documentation example for arrow::stl::TupleRangeFromTable by adding the missing parameters (arrow::compute::CastOptions and arrow::compute::ExecContext) so the example matches the actual API signature in cpp/src/arrow/stl.h.

Changes:

• Update the narrative text to mention CastOptions and ExecContext are needed for conversions.
• Update the code snippet to construct ExecContext / CastOptions and pass them to TupleRangeFromTable.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[pitrou]

+1, thank you @thisisnic

[conbench-apache-arrow]

After merging your PR, Conbench analyzed the 3 benchmarking runs that have been run so far on merge-commit 901a6d5.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details. It also includes information about 2 possible false positives for unstable benchmarks that are known to sometimes produce them.