Designing a C++ API, I came across an interesting problem lately. A member function was returning a pointer a newly created object and it wasn't apparent (without reading the documentation) if the ...