offmap: introduce high-level getter for values

The current way of looking up an entry from a map is tightly coupled with the
map implementation, as one first has to look up the index of the key and then
retrieve the associated value by using the index. As a caller, you usually do
not care about any indices at all, though, so this is more complicated than
really necessary. Furthermore, it invites for errors to happen if the correct
error checking sequence is not being followed.

Introduce a new high-level function `git_offmap_get` that takes a map and a key
and returns a pointer to the associated value if such a key exists. Otherwise,
a `NULL` pointer is returned. Adjust all callers that can trivially be
converted.

1 files changed, 9 insertions, 0 deletions

diff --git a/src/offmap.c b/src/offmap.c
index 2b447b392..561b63cf2 100644
--- a/src/offmap.c
+++ b/src/offmap.c
@@ -42,6 +42,15 @@ size_t git_offmap_size(git_offmap *map)
 	return kh_size(map);
 }
 
+void *git_offmap_get(git_offmap *map, const git_off_t key)
+{
+	size_t idx = git_offmap_lookup_index(map, key);
+	if (!git_offmap_valid_index(map, idx) ||
+	    !git_offmap_has_data(map, idx))
+		return NULL;
+	return kh_val(map, idx);
+}
+
 size_t git_offmap_lookup_index(git_offmap *map, const git_off_t key)
 {
 	return kh_get(off, map, key);