Changeset 70427 in vbox

Timestamp:

Jan 2, 2018 2:59:56 PM (7 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

120032

Message:

IPRT: Added RTUtf16NCmpAscii. [build fix]

File:

• trunk/include/iprt/utf16.h (modified) (4 diffs)

trunk/include/iprt/utf16.h

@@ -382 +382 @@
  * Performs a case sensitive string compare between two UTF-16 strings.
  *
- * @returns < 0 if the first string less than the second string.s
+ * @returns < 0 if the first string less than the second string.
  * @returns 0 if the first string identical to the second string.
  * @returns > 0 if the first string greater than the second string.
@@ -395 +395 @@
  * ASCII string.
  *
- * @returns < 0 if the first string less than the second string.s
+ * @returns < 0 if the first string less than the second string.
  * @returns 0 if the first string identical to the second string.
  * @returns > 0 if the first string greater than the second string.
@@ -408 +408 @@
  * string.
  *
- * @returns < 0 if the first string less than the second string.s
+ * @returns < 0 if the first string less than the second string.
  * @returns 0 if the first string identical to the second string.
  * @returns > 0 if the first string greater than the second string.
@@ -416 +416 @@
  */
 RTDECL(int) RTUtf16CmpUtf8(PCRTUTF16 pwsz1, const char *psz2);
+
+
+/**
+ * Performs a case sensitive and length limited string compare between two UTF-16 strings.
+ *
+ * @returns < 0 if the first string less than the second string.
+ * @returns 0 if the first string identical to the second string.
+ * @returns > 0 if the first string greater than the second string.
+ * @param   pwsz1       First UTF-16 string. Null is allowed.
+ * @param   pwsz2       Second UTF-16 string. Null is allowed.
+ * @param   cwcMax1     Maximum number of characters (RTUTF16) from the first
+ * @remark  This function will not make any attempt to validate the encoding.
+ */
+RTDECL(int) RTUtf16NCmp(PCRTUTF16 pwsz1, PCRTUTF16 pwsz2, size_t cwcMax);
+
+/**
+ * Performs a case sensitive and length limited string compare between an UTF-16
+ * string and a pure ASCII string.
+ *
+ * @returns < 0 if the first string less than the second string.
+ * @returns 0 if the first string identical to the second string.
+ * @returns > 0 if the first string greater than the second string.
+ * @param   pwsz1       First UTF-16 string. Null is allowed.
+ * @param   psz2        Second string, pure ASCII. Null is allowed.
+ * @param   cwcMax      Maximum number of characters (RTUTF16) to compare.
+ * @remark  This function will not make any attempt to validate the encoding.
+ */
+RTDECL(int) RTUtf16NCmpAscii(PCRTUTF16 pwsz1, const char *psz2, size_t cwcMax);
+
+/**
+ * Performs a case sensitive and length limited string compare between an UTF-16
+ * string and a UTF-8 string.
+ *
+ * @returns < 0 if the first string less than the second string.
+ * @returns 0 if the first string identical to the second string.
+ * @returns > 0 if the first string greater than the second string.
+ * @param   pwsz1       First UTF-16 string. Null is allowed.
+ * @param   psz2        Second string, UTF-8. Null is allowed.
+ * @param   cwcMax1     Maximum number of UTF-16 characters (RTUTF16) from the
+ *                      first string to compare.
+ * @param   cchMax2     Maximum number of UTF-8 characters (char) from the
+ *                      second string to compare.
+ * @remarks NULL and empty strings are treated equally.
+ */
+RTDECL(int) RTUtf16NCmpUtf8(PCRTUTF16 pwsz1, const char *psz2, size_t cwcMax);
+
 
 /**