diff options
| author | Heiko Voigt <hvoigt@hvoigt.net> | 2012-03-29 09:21:22 +0200 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2012-03-30 09:06:04 -0700 |
| commit | b8939b2b3abaa99c18bf57251cd2828b89ac38c5 (patch) | |
| tree | 8af94e0a930a6887d6e1978b21f4872d6f395280 | |
| parent | 8ced9c90a28f6abc80dc5ad4cf7921c2322c0bb0 (diff) | |
| download | git-b8939b2b3abaa99c18bf57251cd2828b89ac38c5.tar.gz git-b8939b2b3abaa99c18bf57251cd2828b89ac38c5.tar.xz | |
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>
| -rw-r--r-- | Documentation/technical/api-string-list.txt | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/Documentation/technical/api-string-list.txt b/Documentation/technical/api-string-list.txt index ce24eb96f..5a0c14fce 100644 --- a/Documentation/technical/api-string-list.txt +++ b/Documentation/technical/api-string-list.txt @@ -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 |