# HG changeset patch # User Mike Becker # Date 1395132830 -3600 # Node ID 302dddaf741daf4dfc8700df53f6aa44fa0ba592 # Parent a22b6da0587e901aa620e6355c0b4711806e1f2c fixed documentation error in sstr_split diff -r a22b6da0587e -r 302dddaf741d ucx/string.h --- a/ucx/string.h Fri Jan 17 12:44:54 2014 +0100 +++ b/ucx/string.h Tue Mar 18 09:53:50 2014 +0100 @@ -227,7 +227,7 @@ * * * The integer referenced by count is used as input and determines - * the maximum size of the resulting list, i.e. the maximum count of splits to + * the maximum size of the resulting array, i.e. the maximum count of splits to * perform + 1. * * The integer referenced by count is also used as output and is @@ -237,24 +237,24 @@ *
  • -1, if either the string or the delimiter is an empty string
  • *
  • 0, if the string equals the delimiter
  • *
  • 1, if the string does not contain the delimiter
  • - *
  • the count of list items, otherwise
  • + *
  • the count of array items, otherwise
  • * * * If the string starts with the delimiter, the first item of the resulting - * list will be an empty string. + * array will be an empty string. * * If the string ends with the delimiter and the maximum list size is not - * exceeded, the last list item will be an empty string. + * exceeded, the last array item will be an empty string. * - * Attention: All list items AND all sstr_t.ptr of the list + * Attention: The array pointer AND all sstr_t.ptr of the array * items must be manually passed to free(). Use sstrsplit_a() with * an allocator to managed memory, to avoid this. * * @param string the string to split * @param delim the delimiter string - * @param count IN: the maximum size of the resulting list (0 for an - * unbounded list), OUT: the actual size of the list - * @return a list of the split strings as sstr_t array or + * @param count IN: the maximum size of the resulting array (0 = no limit), + * OUT: the actual size of the array + * @return a sstr_t array containing the split strings or * NULL on error * * @see sstrsplit_a() @@ -266,7 +266,7 @@ * * Read the description of sstrsplit() for details. * - * The memory for the sstr_t.ptr pointers of the list items and the memory for + * The memory for the sstr_t.ptr pointers of the array items and the memory for * the sstr_t array itself are allocated by using the UcxAllocator.malloc() * function. * @@ -276,9 +276,9 @@ * @param allocator the UcxAllocator used for allocating memory * @param string the string to split * @param delim the delimiter string - * @param count IN: the maximum size of the resulting list (0 for an - * unbounded list), OUT: the actual size of the list - * @return a list of the split strings as sstr_t array or + * @param count IN: the maximum size of the resulting array (0 = no limit), + * OUT: the actual size of the array + * @return a sstr_t array containing the split strings or * NULL on error * * @see sstrsplit()