Add example code to the C implementation and update documentation

This patch adds some example code to help people understand the C API. It also fixes some memory leaks in record, map and array datatypes found while building the example.