Removing Key/Value Pairs

In contrast to the many functions required to add a key/value pair to a GATTable, there exists a single function to remove a given key/value pair. It is the following function

GATResult GATTable_Remove(GATTable table, const void *key)

The first argument to this function is the GATTable from which the key/value pair is to be removed. The second argument to this function is the of the key/value pair which is to be removed. Upon successful completion of this function, there will exist no key/value pair mapping in the passed GATTable instance corresponding to this passed key. The GATResult, covered in Appendix , returned from this function indicates its completion status.