ICU-542 add u_strToUpper/Lower() (for now "not supported")

X-SVN-Rev: 2920

icu4c/source/common/uchar.c

@@ -888,3 +888,23 @@ void u_getUnicodeVersion(UVersionInfo versionArray) {
         uprv_memcpy(versionArray, dataVersion, U_MAX_VERSION_LENGTH);
     }
 }
+
+/* string casing ------------------------------------------------------------ */
+
+U_CAPI int32_t U_EXPORT2
+u_strToUpper(const UChar *src, int32_t srcLength,
+             UChar *dest, int32_t destCapacity,
+             const char *locale,
+             UErrorCode *pErrorCode) {
+    *pErrorCode=U_UNSUPPORTED_ERROR;
+    return 0;
+}
+
+U_CAPI int32_t U_EXPORT2
+u_strToLower(const UChar *src, int32_t srcLength,
+             UChar *dest, int32_t destCapacity,
+             const char *locale,
+             UErrorCode *pErrorCode) {
+    *pErrorCode=U_UNSUPPORTED_ERROR;
+    return 0;
+}

icu4c/source/common/unicode/ustring.h

@@ -327,4 +327,53 @@ u_unescapeAt(UNESCAPE_CHAR_AT charAt,
              int32_t *offset,
              int32_t length,
              void *context);
+
+/**
+ * Uppercase the characters in a string.
+ * Casing is locale-dependent and context-sensitive.
+ * The result may be longer or shorter than the original.
+ *
+ * @param src       The original string
+ * @param srcLength The length of the original string. If -1, then src must be zero-terminated.
+ * @param dest      A buffer for the result string. The result will be zero-terminated if
+ *                  the buffer is large enough.
+ * @param destCapacity The size of the buffer (number of UChars). If it is 0, then
+ *                  dest may be NULL and the function will only return the length of the result
+ *                  without writing any of the result string.
+ * @param locale    The locale to consider, or NULL for none.
+ * @param pErrorCode Must be a valid pointer to an error code value,
+ *                  which must not indicate a failure before the function call.
+ * @return The length of the result string. It may be greater than destCapacity. In that case,
+ *         only some of the result was written to the destination buffer.
+ */
+U_CAPI int32_t U_EXPORT2
+u_strToUpper(const UChar *src, int32_t srcLength,
+             UChar *dest, int32_t destCapacity,
+             const char *locale,
+             UErrorCode *pErrorCode);
+
+/**
+ * Lowercase the characters in a string.
+ * Casing is locale-dependent and context-sensitive.
+ * The result may be longer or shorter than the original.
+ *
+ * @param src       The original string
+ * @param srcLength The length of the original string. If -1, then src must be zero-terminated.
+ * @param dest      A buffer for the result string. The result will be zero-terminated if
+ *                  the buffer is large enough.
+ * @param destCapacity The size of the buffer (number of UChars). If it is 0, then
+ *                  dest may be NULL and the function will only return the length of the result
+ *                  without writing any of the result string.
+ * @param locale    The locale to consider, or NULL for none.
+ * @param pErrorCode Must be a valid pointer to an error code value,
+ *                  which must not indicate a failure before the function call.
+ * @return The length of the result string. It may be greater than destCapacity. In that case,
+ *         only some of the result was written to the destination buffer.
+ */
+U_CAPI int32_t U_EXPORT2
+u_strToLower(const UChar *src, int32_t srcLength,
+             UChar *dest, int32_t destCapacity,
+             const char *locale,
+             UErrorCode *pErrorCode);
+
 #endif