| /* |
| ********************************************************************** |
| * Copyright (C) 1999-2011, International Business Machines |
| * Corporation and others. All Rights Reserved. |
| ********************************************************************** |
| * file name: ustr_imp.h |
| * encoding: US-ASCII |
| * tab size: 8 (not used) |
| * indentation:4 |
| * |
| * created on: 2001jan30 |
| * created by: Markus W. Scherer |
| */ |
| |
| #ifndef __USTR_IMP_H__ |
| #define __USTR_IMP_H__ |
| |
| #include "unicode/utypes.h" |
| #include "unicode/uiter.h" |
| #include "ucase.h" |
| |
| /** Simple declaration to avoid including unicode/ubrk.h. */ |
| #ifndef UBRK_TYPEDEF_UBREAK_ITERATOR |
| # define UBRK_TYPEDEF_UBREAK_ITERATOR |
| typedef struct UBreakIterator UBreakIterator; |
| #endif |
| |
| #ifndef U_COMPARE_IGNORE_CASE |
| /* see also unorm.h */ |
| /** |
| * Option bit for unorm_compare: |
| * Perform case-insensitive comparison. |
| */ |
| #define U_COMPARE_IGNORE_CASE 0x10000 |
| #endif |
| |
| /** |
| * Internal option for unorm_cmpEquivFold() for strncmp style. |
| * If set, checks for both string length and terminating NUL. |
| */ |
| #define _STRNCMP_STYLE 0x1000 |
| |
| /** |
| * Compare two strings in code point order or code unit order. |
| * Works in strcmp style (both lengths -1), |
| * strncmp style (lengths equal and >=0, flag TRUE), |
| * and memcmp/UnicodeString style (at least one length >=0). |
| */ |
| U_CFUNC int32_t U_EXPORT2 |
| uprv_strCompare(const UChar *s1, int32_t length1, |
| const UChar *s2, int32_t length2, |
| UBool strncmpStyle, UBool codePointOrder); |
| |
| /** |
| * Internal API, used by u_strcasecmp() etc. |
| * Compare strings case-insensitively, |
| * in code point order or code unit order. |
| */ |
| U_CFUNC int32_t |
| u_strcmpFold(const UChar *s1, int32_t length1, |
| const UChar *s2, int32_t length2, |
| uint32_t options, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * Are the Unicode properties loaded? |
| * This must be used before internal functions are called that do |
| * not perform this check. |
| * Generate a debug assertion failure if data is not loaded. |
| */ |
| U_CFUNC UBool |
| uprv_haveProperties(UErrorCode *pErrorCode); |
| |
| /** |
| * Load the Unicode property data. |
| * Intended primarily for use from u_init(). |
| * Has no effect if property data is already loaded. |
| * NOT thread safe. |
| */ |
| /*U_CFUNC int8_t |
| uprv_loadPropsData(UErrorCode *errorCode);*/ |
| |
| /* |
| * Internal string casing functions implementing |
| * ustring.h/ustrcase.c and UnicodeString case mapping functions. |
| */ |
| |
| struct UCaseMap { |
| const UCaseProps *csp; |
| #if !UCONFIG_NO_BREAK_ITERATION |
| UBreakIterator *iter; /* We adopt the iterator, so we own it. */ |
| #endif |
| char locale[32]; |
| int32_t locCache; |
| uint32_t options; |
| }; |
| |
| #ifndef __UCASEMAP_H__ |
| typedef struct UCaseMap UCaseMap; |
| #endif |
| |
| #if UCONFIG_NO_BREAK_ITERATION |
| # define UCASEMAP_INITIALIZER { NULL, { 0 }, 0, 0 } |
| #else |
| # define UCASEMAP_INITIALIZER { NULL, NULL, { 0 }, 0, 0 } |
| #endif |
| |
| U_CFUNC void |
| ustrcase_setTempCaseMapLocale(UCaseMap *csm, const char *locale); |
| |
| #ifndef U_STRING_CASE_MAPPER_DEFINED |
| #define U_STRING_CASE_MAPPER_DEFINED |
| |
| /** |
| * String case mapping function type, used by ustrcase_map(). |
| * All error checking must be done. |
| * The UCaseMap must be fully initialized, with locale and/or iter set as needed. |
| * src and dest must not overlap. |
| */ |
| typedef int32_t U_CALLCONV |
| UStringCaseMapper(const UCaseMap *csm, |
| UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| #endif |
| |
| /** Implements UStringCaseMapper. */ |
| U_CFUNC int32_t U_CALLCONV |
| ustrcase_internalToLower(const UCaseMap *csm, |
| UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| /** Implements UStringCaseMapper. */ |
| U_CFUNC int32_t U_CALLCONV |
| ustrcase_internalToUpper(const UCaseMap *csm, |
| UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| #if !UCONFIG_NO_BREAK_ITERATION |
| |
| /** Implements UStringCaseMapper. */ |
| U_CFUNC int32_t U_CALLCONV |
| ustrcase_internalToTitle(const UCaseMap *csm, |
| UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| #endif |
| |
| /** Implements UStringCaseMapper. */ |
| U_CFUNC int32_t U_CALLCONV |
| ustrcase_internalFold(const UCaseMap *csm, |
| UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * Implements argument checking and buffer handling |
| * for string case mapping as a common function. |
| */ |
| U_CFUNC int32_t |
| ustrcase_map(const UCaseMap *csm, |
| UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| UStringCaseMapper *stringCaseMapper, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * UTF-8 string case mapping function type, used by ucasemap_mapUTF8(). |
| * UTF-8 version of UStringCaseMapper. |
| * All error checking must be done. |
| * The UCaseMap must be fully initialized, with locale and/or iter set as needed. |
| * src and dest must not overlap. |
| */ |
| typedef int32_t U_CALLCONV |
| UTF8CaseMapper(const UCaseMap *csm, |
| uint8_t *dest, int32_t destCapacity, |
| const uint8_t *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| /** Implements UTF8CaseMapper. */ |
| U_CFUNC int32_t U_CALLCONV |
| ucasemap_internalUTF8ToTitle(const UCaseMap *csm, |
| uint8_t *dest, int32_t destCapacity, |
| const uint8_t *src, int32_t srcLength, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * Implements argument checking and buffer handling |
| * for UTF-8 string case mapping as a common function. |
| */ |
| U_CFUNC int32_t |
| ucasemap_mapUTF8(const UCaseMap *csm, |
| uint8_t *dest, int32_t destCapacity, |
| const uint8_t *src, int32_t srcLength, |
| UTF8CaseMapper *stringCaseMapper, |
| UErrorCode *pErrorCode); |
| |
| U_CAPI int32_t U_EXPORT2 |
| ustr_hashUCharsN(const UChar *str, int32_t length); |
| |
| U_CAPI int32_t U_EXPORT2 |
| ustr_hashCharsN(const char *str, int32_t length); |
| |
| U_CAPI int32_t U_EXPORT2 |
| ustr_hashICharsN(const char *str, int32_t length); |
| |
| /** |
| * NUL-terminate a UChar * string if possible. |
| * If length < destCapacity then NUL-terminate. |
| * If length == destCapacity then do not terminate but set U_STRING_NOT_TERMINATED_WARNING. |
| * If length > destCapacity then do not terminate but set U_BUFFER_OVERFLOW_ERROR. |
| * |
| * @param dest Destination buffer, can be NULL if destCapacity==0. |
| * @param destCapacity Number of UChars available at dest. |
| * @param length Number of UChars that were (to be) written to dest. |
| * @param pErrorCode ICU error code. |
| * @return length |
| */ |
| U_CAPI int32_t U_EXPORT2 |
| u_terminateUChars(UChar *dest, int32_t destCapacity, int32_t length, UErrorCode *pErrorCode); |
| |
| /** |
| * NUL-terminate a char * string if possible. |
| * Same as u_terminateUChars() but for a different string type. |
| */ |
| U_CAPI int32_t U_EXPORT2 |
| u_terminateChars(char *dest, int32_t destCapacity, int32_t length, UErrorCode *pErrorCode); |
| |
| /** |
| * NUL-terminate a UChar32 * string if possible. |
| * Same as u_terminateUChars() but for a different string type. |
| */ |
| U_CAPI int32_t U_EXPORT2 |
| u_terminateUChar32s(UChar32 *dest, int32_t destCapacity, int32_t length, UErrorCode *pErrorCode); |
| |
| /** |
| * NUL-terminate a wchar_t * string if possible. |
| * Same as u_terminateUChars() but for a different string type. |
| */ |
| U_CAPI int32_t U_EXPORT2 |
| u_terminateWChars(wchar_t *dest, int32_t destCapacity, int32_t length, UErrorCode *pErrorCode); |
| |
| #endif |