| /* |
| ********************************************************************** |
| * Copyright (C) 1999-2001, 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/ucnv.h" |
| |
| /** |
| * Are the Unicode properties loaded? |
| * This must be used before internal functions are called that do |
| * not perform this check. |
| * @internal |
| */ |
| U_CFUNC UBool |
| uprv_haveProperties(void); |
| |
| /** |
| * Type of a function that may be passed to the internal case mapping functions |
| * or similar for growing the destination buffer. |
| * @internal |
| */ |
| typedef UBool U_CALLCONV |
| UGrowBuffer(void *context, /* opaque pointer for this function */ |
| UChar **pBuffer, /* in/out destination buffer pointer */ |
| int32_t *pCapacity, /* in/out buffer capacity in numbers of UChars */ |
| int32_t reqCapacity,/* requested capacity */ |
| int32_t length); /* number of UChars to be copied to new buffer */ |
| |
| /** |
| * Default implementation of UGrowBuffer. |
| * Takes a static buffer as context, allocates a new buffer, |
| * and releases the old one if it is not the same as the one passed as context. |
| * @internal |
| */ |
| U_CAPI UBool /* U_CALLCONV U_EXPORT2 */ |
| u_growBufferFromStatic(void *context, |
| UChar **pBuffer, int32_t *pCapacity, int32_t reqCapacity, |
| int32_t length); |
| |
| /* |
| * Internal string casing functions implementing ustring.c and UnicodeString |
| * case mapping functions. |
| * @internal |
| */ |
| U_CFUNC int32_t |
| u_internalStrToLower(UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| const char *locale, |
| UGrowBuffer *growBuffer, void *context, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * @internal |
| */ |
| U_CFUNC int32_t |
| u_internalStrToUpper(UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| const char *locale, |
| UGrowBuffer *growBuffer, void *context, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * Internal case folding function. |
| * @internal |
| */ |
| U_CFUNC int32_t |
| u_internalStrFoldCase(UChar *dest, int32_t destCapacity, |
| const UChar *src, int32_t srcLength, |
| uint32_t options, |
| UGrowBuffer *growBuffer, void *context, |
| UErrorCode *pErrorCode); |
| |
| /** |
| * Get the full title case mapping for c (does not check context!). |
| * @return the length of the output, negative if same as c |
| * @internal |
| */ |
| U_CAPI int32_t U_EXPORT2 |
| u_internalTitleCase(UChar32 c, UChar *dest, int32_t destCapacity, const char *locale); |
| |
| /** |
| * Return the full case folding mapping for c. |
| * Must be used only if uprv_haveProperties() is true. |
| * @internal |
| */ |
| U_CFUNC int32_t |
| u_internalFoldCase(UChar32 c, UChar dest[32], uint32_t options); |
| |
| /** |
| * Internal case-insensitive string compare function. |
| * @internal |
| */ |
| U_CFUNC int32_t |
| u_internalStrcasecmp(const UChar *s1, int32_t length1, |
| const UChar *s2, int32_t length2, |
| uint32_t options); |
| |
| /** |
| * Internal, somewhat faster version of u_getCombiningClass() |
| * for use by normalization quick check etc. |
| * First make sure that data is loaded by u_getCombiningClass(0x300)!=0 |
| * or uprv_haveProperties() is true. |
| * @internal |
| */ |
| U_CFUNC uint8_t |
| u_internalGetCombiningClass(UChar32 c); |
| |
| /** |
| * Get the default converter. This is a commonly used converter |
| * that is used for the ustring and UnicodeString API. |
| * Remember to use the u_releaseDefaultConverter when you are done. |
| * @internal |
| */ |
| U_CAPI UConverter* U_EXPORT2 |
| u_getDefaultConverter(UErrorCode *status); |
| |
| |
| /** |
| * Release the default converter to the converter cache. |
| * @internal |
| */ |
| U_CAPI void U_EXPORT2 |
| u_releaseDefaultConverter(UConverter *converter); |
| |
| /** |
| * 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 |
| * @internal |
| */ |
| 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); |
| |
| #define u_getMaxCaseExpansion() 10 |
| |
| #endif |