Mercurial > hg > ucx / changeset

--- a/ucx/string.h	Mon Jul 14 16:54:10 2014 +0200
+++ b/ucx/string.h	Mon Jul 21 13:04:57 2014 +0200
@@ -120,13 +120,34 @@
 size_t sstrnlen(size_t count, sstr_t string, ...);
 
 /**
- * Concatenates strings.
+ * Concatenates two or more strings.
+ * 
+ * The resulting string will be allocated by standard <code>malloc()</code>. 
+ * So developers <b>MUST</b> pass the sstr_t.ptr to <code>free()</code>.
+ * 
+ * The sstr_t.ptr of the return value will <i>always</i> be <code>NULL</code>-
+ * terminated.
  *
  * @param count   the total number of strings to concatenate
- * @param ...     all strings
+ * @param s1      first string
+ * @param s2      second string
+ * @param ...     all remaining strings
  * @return the concatenated string
  */
 sstr_t sstrcat(size_t count, sstr_t s1, sstr_t s2, ...);
+
+/**
+ * Concatenates two or more strings using an UcxAllocator.
+ * 
+ * See sstrcat() for details.
+ *
+ * @param a       the allocator to use
+ * @param count   the total number of strings to concatenate
+ * @param s1      first string
+ * @param s2      second string
+ * @param ...     all remaining strings
+ * @return the concatenated string
+ */
 sstr_t sstrcat_a(UcxAllocator *a, size_t count, sstr_t s1, sstr_t s2, ...);