168 lines
5.2 KiB
C
168 lines
5.2 KiB
C
/*
|
|
**********************************************************************
|
|
* 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);
|
|
|
|
/**
|
|
* 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);
|
|
|
|
#endif
|