[ARROW-9428] [C++] Update documentation for buffer allocation functions

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 0.17.1
• Fix Version/s: 1.0.0
• Component/s: C++, Documentation
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/17271
• Assignee: Antoine Pitrou
• Reporter: Mathieu Dutour Sikiric
• Created: 13/Jul/20 10:39
• Updated: 11/Jan/23 08:06
• Resolved: 13/Jul/20 17:30

Description

The memory allocation of buffers as documented in

https://arrow.apache.org/docs/cpp/memory.html

has the unfortunate property that it is indicated as "obsolete" when compiling.

The proposed API using the "Result" and unique pointer construction is not obvious to use.

Could the documentation be updated for the new API? Complete example would be appreciated especially considering that the use of unique pointer seems to contradict the use of shared pointer in other parts of the API.

 

Issue Links

• links to: GitHub Pull Request #7731