Browse Source

string-list: document that string_list_insert() inserts unique strings

Signed-off-by: Heiko Voigt <hvoigt@hvoigt.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Heiko Voigt 13 years ago committed by Junio C Hamano
parent
commit
b8939b2b3a
  1. 4
      Documentation/technical/api-string-list.txt

4
Documentation/technical/api-string-list.txt

@ -83,7 +83,9 @@ Functions @@ -83,7 +83,9 @@ Functions

Insert a new element to the string_list. The returned pointer can be
handy if you want to write something to the `util` pointer of the
string_list_item containing the just added string.
string_list_item containing the just added string. If the given
string already exists the insertion will be skipped and the
pointer to the existing item returned.
+
Since this function uses xrealloc() (which die()s if it fails) if the
list needs to grow, it is safe not to check the pointer. I.e. you may

Loading…
Cancel
Save