From: Stefan Beller Date: Mon, 24 Nov 2014 21:22:02 +0000 (-0800) Subject: string_list: document string_list_(insert,lookup) X-Git-Tag: v2.3.0-rc0~54^2~2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=fc66505c53f1a471e63b6122b2d629daca6e705b;p=thirdparty%2Fgit.git string_list: document string_list_(insert,lookup) Signed-off-by: Stefan Beller Signed-off-by: Junio C Hamano --- diff --git a/string-list.h b/string-list.h index 494eb5d95d..40ffe0c703 100644 --- a/string-list.h +++ b/string-list.h @@ -55,9 +55,19 @@ void string_list_remove_empty_items(struct string_list *list, int free_util); int string_list_has_string(const struct string_list *list, const char *string); int string_list_find_insert_index(const struct string_list *list, const char *string, int negative_existing_index); +/* + * Inserts the given string into the sorted list. + * If the string already exists, the list is not altered. + * Returns the string_list_item, the string is part of. + */ struct string_list_item *string_list_insert(struct string_list *list, const char *string); struct string_list_item *string_list_insert_at_index(struct string_list *list, int insert_at, const char *string); + +/* + * Checks if the given string is part of a sorted list. If it is part of the list, + * return the coresponding string_list_item, NULL otherwise. + */ struct string_list_item *string_list_lookup(struct string_list *list, const char *string); /*