267 lines
8.3 KiB
C
267 lines
8.3 KiB
C
/*
|
|
**********************************************************************
|
|
* Copyright (C) 1999-2015, 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);
|
|
|
|
/**
|
|
* Interanl API, used for detecting length of
|
|
* shared prefix case-insensitively.
|
|
* @param s1 input string 1
|
|
* @param length1 length of string 1, or -1 (NULL terminated)
|
|
* @param s2 input string 2
|
|
* @param length2 length of string 2, or -1 (NULL terminated)
|
|
* @param options compare options
|
|
* @param matchLen1 (output) length of partial prefix match in s1
|
|
* @param matchLen2 (output) length of partial prefix match in s2
|
|
* @param pErrorCode receives error status
|
|
*/
|
|
U_CAPI void
|
|
u_caseInsensitivePrefixMatch(const UChar *s1, int32_t length1,
|
|
const UChar *s2, int32_t length2,
|
|
uint32_t options,
|
|
int32_t *matchLen1, int32_t *matchLen2,
|
|
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
|