use 'convert' as more precise term than 'cast' for the conversion from sstr_t to scstr_t

Wed, 16 May 2018 19:01:21 +0200

author
Mike Becker <universe@uap-core.de>
date
Wed, 16 May 2018 19:01:21 +0200
changeset 320
0ffb71f15426
parent 319
0380e438a7ce
child 321
9af21a50b516

use 'convert' as more precise term than 'cast' for the conversion from sstr_t to scstr_t

src/ucx/string.h file | annotate | diff | comparison | revisions
--- a/src/ucx/string.h	Wed May 16 18:56:44 2018 +0200
+++ b/src/ucx/string.h	Wed May 16 19:01:21 2018 +0200
@@ -110,7 +110,7 @@
 /**
  * One of two type adjustment functions that return a scstr_t.
  * 
- * Used internally to cast a UCX string to an immutable UCX string.
+ * Used internally to convert a UCX string to an immutable UCX string.
  * This variant is used, when the string is already immutable and no operation
  * needs to be performed.
  * 
@@ -122,7 +122,7 @@
 /**
  * One of two type adjustment functions that return a scstr_t.
  * 
- * Used internally to cast a UCX string to an immutable UCX string.
+ * Used internally to convert a UCX string to an immutable UCX string.
  * 
  * @param str some sstr_t
  * @return an immutable (scstr_t) version of the provided string.
@@ -167,7 +167,7 @@
  * Casts a UCX string to an immutable UCX string (scstr_t).
  * 
  * This internal function (ab)uses the C standard an expects one single
- * argument which is then implicitly casted to scstr_t without a warning.
+ * argument which is then implicitly converted to scstr_t without a warning.
  * 
  * @return the an immutable version of the provided string
  */
@@ -266,7 +266,7 @@
 size_t scstrnlen(size_t count, ...);
 
 /**
- * Alias for scstrnlen() which automatically casts the arguments.
+ * Alias for scstrnlen() which automatically converts the arguments.
  * 
  * @param count    the total number of specified strings (so at least 1)
  * @param ...      all strings
@@ -291,7 +291,7 @@
 sstr_t scstrcat(size_t count, scstr_t s1, ...);
 
 /**
- * Alias for scstrcat() which automatically casts the arguments.
+ * Alias for scstrcat() which automatically converts the arguments.
  * 
  * @param count   the total number of strings to concatenate
  * @param s1      first string
@@ -314,7 +314,7 @@
 sstr_t scstrcat_a(UcxAllocator *a, size_t count, scstr_t s1, ...);
 
 /**
- * Alias for scstrcat_a() which automatically casts the arguments.
+ * Alias for scstrcat_a() which automatically converts the arguments.
  * 
  * See sstrcat() for details.
  *
@@ -471,7 +471,7 @@
 sstr_t scstrsstr(sstr_t string, scstr_t match);
 
 /**
- * Alias for scstrsstr() which automatically casts the match string.
+ * Alias for scstrsstr() which automatically converts the match string.
  * 
  * @param string the string to be scanned
  * @param match  string containing the sequence of characters to match
@@ -499,7 +499,7 @@
 scstr_t scstrscstr(scstr_t string, scstr_t match);
 
 /**
- * Alias for scstrscstr() which automatically casts the match string.
+ * Alias for scstrscstr() which automatically converts the match string.
  * 
  * @param string the string to be scanned
  * @param match  string containing the sequence of characters to match
@@ -559,7 +559,7 @@
 sstr_t* scstrsplit(scstr_t string, scstr_t delim, ssize_t *count);
 
 /**
- * Alias for scstrsplit() which automatically casts the arguments.
+ * Alias for scstrsplit() which automatically converts the arguments.
  * 
  * @param string the string to split
  * @param delim  the delimiter string
@@ -599,7 +599,7 @@
         ssize_t *count);
 
 /**
- * Alias for scstrsplit_a() which automatically casts the arguments.
+ * Alias for scstrsplit_a() which automatically converts the arguments.
  * 
  * @param allocator the UcxAllocator used for allocating memory
  * @param string the string to split
@@ -629,7 +629,7 @@
 int scstrcmp(scstr_t s1, scstr_t s2);
 
 /**
- * Alias for scstrcmp() which automatically casts its arguments.
+ * Alias for scstrcmp() which automatically converts its arguments.
  * 
  * @param s1 the first string
  * @param s2 the second string
@@ -655,7 +655,7 @@
 int scstrcasecmp(scstr_t s1, scstr_t s2);
 
 /**
- * Alias for scstrcasecmp() which automatically casts the arguments.
+ * Alias for scstrcasecmp() which automatically converts the arguments.
  * 
  * @param s1 the first string
  * @param s2 the second string
@@ -682,7 +682,7 @@
 sstr_t scstrdup(scstr_t string);
 
 /**
- * Alias for scstrdup() which automatically casts the argument.
+ * Alias for scstrdup() which automatically converts the argument.
  * 
  * @param string the string to duplicate
  * @return a duplicate of the string
@@ -709,7 +709,7 @@
 sstr_t scstrdup_a(UcxAllocator *allocator, scstr_t string);
 
 /**
- * Alias for scstrdup_a() which automatically casts the argument.
+ * Alias for scstrdup_a() which automatically converts the argument.
  * 
  * @param allocator a valid instance of a UcxAllocator
  * @param string the string to duplicate
@@ -766,7 +766,7 @@
 int scstrprefix(scstr_t string, scstr_t prefix);
 
 /**
- * Alias for scstrprefix() which automatically casts the arguments.
+ * Alias for scstrprefix() which automatically converts the arguments.
  * 
  * @param string the string to check
  * @param prefix the prefix the string should have
@@ -783,7 +783,7 @@
 int scstrsuffix(scstr_t string, scstr_t suffix);
 
 /**
- * Alias for scstrsuffix() which automatically casts the arguments.
+ * Alias for scstrsuffix() which automatically converts the arguments.
  *
  * @param string the string to check
  * @param suffix the suffix the string should have
@@ -804,7 +804,7 @@
 sstr_t scstrlower(scstr_t string);
 
 /**
- * Alias for scstrlower() which automatically casts the argument.
+ * Alias for scstrlower() which automatically converts the argument.
  * 
  * @param string the input string
  * @return the resulting lower case string
@@ -826,7 +826,7 @@
 
 
 /**
- * Alias for scstrlower_a() which automatically casts the argument.
+ * Alias for scstrlower_a() which automatically converts the argument.
  * 
  * @param allocator the allocator used for duplicating the string
  * @param string the input string
@@ -847,7 +847,7 @@
 sstr_t scstrupper(scstr_t string);
 
 /**
- * Alias for scstrupper() which automatically casts the argument.
+ * Alias for scstrupper() which automatically converts the argument.
  * 
  * @param string the input string
  * @return the resulting upper case string
@@ -868,7 +868,7 @@
 sstr_t scstrupper_a(UcxAllocator *allocator, scstr_t string);
 
 /**
- * Alias for scstrupper_a() which automatically casts the argument.
+ * Alias for scstrupper_a() which automatically converts the argument.
  * 
  * @param allocator the allocator used for duplicating the string
  * @param string the input string

mercurial