transfer the container (list, array, hash table) from the callee to the caller.
The callee retains the ownership of the individual items in the container and the caller has to free up the container resources (g_list_free()/g_hash_table_destroy() etc) of this transfer.