mdadm: add map_num_s()

[thirdparty/mdadm.git] / maps.c

diff --git a/maps.c b/maps.c
index a4fd27977c3685db7e23795a7582c016fb038d70..20fcf719e5f7e732849df578be93a46609255d0e 100644 (file)
--- a/maps.c
+++ b/maps.c
@@ -166,6 +166,30 @@ mapping_t sysfs_array_states[] = {
        { NULL, ARRAY_UNKNOWN_STATE }
 };
 
+/**
+ * map_num_s() - Safer alternative of map_num() function.
+ * @map: map to search.
+ * @num: key to match.
+ *
+ * Shall be used only if key existence is quaranted.
+ *
+ * Return: Pointer to name of the element.
+ */
+char *map_num_s(mapping_t *map, int num)
+{
+       char *ret = map_num(map, num);
+
+       assert(ret);
+       return ret;
+}
+
+/**
+ * map_num() - get element name by key.
+ * @map: map to search.
+ * @num: key to match.
+ *
+ * Return: Pointer to name of the element or NULL.
+ */
 char *map_num(mapping_t *map, int num)
 {
        while (map->name) {