Parameter points to an array of items.

NULL is ok, both for passing and for returning.

Parameter for input and for returning results. Default is transfer full.

Generics and defining elements of containers and arrays.

Parameter for input. Default is transfer none.

Free data after the code is done.

Don't free data after the code is done.