Update c-api.array.rst

Add a note explaining the ``out`` parameter of some functions.