Changeset 10106 in vbox for trunk/include

Timestamp:

Jul 2, 2008 1:40:07 PM (17 years ago)

Author:

vboxsync

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

32610

Message:

Added RTStrValidateEncoding, RTStrValidateEncodingEx and RTStrIsValidEncoding for explicit UTF-8 validation.

File:

• trunk/include/iprt/string.h (modified) (1 diff)

trunk/include/iprt/string.h

@@ -140 +140 @@
 
 /**
+ * Validates the UTF-8 encoding of the string.
+ *
+ * @returns iprt status code.
+ * @param   psz         The string.
+ */
+RTDECL(int) RTStrValidateEncoding(const char *psz);
+
+/**
+ * Validates the UTF-8 encoding of the string.
+ *
+ * @returns iprt status code.
+ * @param   psz         The string.
+ * @param   cch         The max string length. Use RTSTR_MAX to process the entire string.
+ * @param   fFlags      Teserved for future. Pass 0.
+ */
+RTDECL(int) RTStrValidateEncodingEx(const char *psz, size_t cch, unsigned fFlags);
+
+/**
+ * Checks if the UTF-8 encoding is valid.
+ *
+ * @returns true / false.
+ * @param   psz         The string.
+ */
+RTDECL(bool) RTStrIsValidEncoding(const char *psz);
+
+/**
  * Gets the number of code points the string is made up of, excluding
  * the terminator.