/* ********************************************************************** * Copyright (C) 1998-1999, International Business Machines * Corporation and others. All Rights Reserved. ********************************************************************** * * File unistr.h * * Modification History: * * Date Name Description * 09/25/98 stephen Creation. * 11/11/98 stephen Changed per 11/9 code review. * 04/20/99 stephen Overhauled per 4/16 code review. * 11/18/99 aliu Made to inherit from Replaceable. Added method * handleReplaceBetween(); other methods unchanged. ******************************************************************************* */ #ifndef UNISTR_H #define UNISTR_H #include <limits.h> #include "unicode/utypes.h" #include "unicode/unicode.h" #include "unicode/ucnv.h" #include "unicode/rep.h" // Size of stack buffer for small strings #define US_STACKBUF_SIZE 10 class Locale; class UCharReference; class UnicodeStringStreamer; #if U_SIZEOF_WCHAR_T==U_SIZEOF_UCHAR && U_CHARSET_FAMILY==U_ASCII_FAMILY # define UNICODE_STRING(cs, length) UnicodeString(TRUE, (UChar *)L ## cs, length) #elif U_SIZEOF_UCHAR==1 && U_CHARSET_FAMILY==U_ASCII_FAMILY # define UNICODE_STRING(cs, length) UnicodeString(TRUE, (UChar *)cs, length) #else # define UNICODE_STRING(cs, length) UnicodeString(cs, length, "") #endif class U_COMMON_API UnicodeString : public Replaceable { public: //======================================== // Read-only operations //======================================== /* Comparison - bitwise only - for international comparison use collation */ inline bool_t operator== (const UnicodeString& text) const; inline bool_t operator!= (const UnicodeString& text) const; inline bool_t operator> (const UnicodeString& text) const; inline bool_t operator< (const UnicodeString& text) const; inline bool_t operator>= (const UnicodeString& text) const; inline bool_t operator<= (const UnicodeString& text) const; inline int8_t compare(const UnicodeString& text) const; inline int8_t compare(UTextOffset start, int32_t length, const UnicodeString& srcText) const; inline int8_t compare(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const; inline int8_t compare(const UChar *srcChars, int32_t srcLength) const; inline int8_t compare(UTextOffset start, int32_t length, const UChar *srcChars) const; inline int8_t compare(UTextOffset start, int32_t length, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const; inline int8_t compareBetween(UTextOffset start, UTextOffset limit, const UnicodeString& srcText, UTextOffset srcStart, UTextOffset srcLimit) const; inline bool_t startsWith(const UnicodeString& text) const; inline bool_t startsWith(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const; inline bool_t startsWith(const UChar *srcChars, int32_t srcLength) const; inline bool_t startsWith(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const; inline bool_t endsWith(const UnicodeString& text) const; inline bool_t endsWith(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const; inline bool_t endsWith(const UChar *srcChars, int32_t srcLength) const; inline bool_t endsWith(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const; /* Searching - bitwise only */ inline UTextOffset indexOf(const UnicodeString& text) const; inline UTextOffset indexOf(const UnicodeString& text, UTextOffset start) const; inline UTextOffset indexOf(const UnicodeString& text, UTextOffset start, int32_t length) const; inline UTextOffset indexOf(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength, UTextOffset start, int32_t length) const; inline UTextOffset indexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start) const; inline UTextOffset indexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start, int32_t length) const; UTextOffset indexOf(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength, UTextOffset start, int32_t length) const; inline UTextOffset indexOf(UChar c) const; inline UTextOffset indexOf(UChar c, UTextOffset start) const; inline UTextOffset indexOf(UChar c, UTextOffset start, int32_t length) const; inline UTextOffset lastIndexOf(const UnicodeString& text) const; inline UTextOffset lastIndexOf(const UnicodeString& text, UTextOffset start) const; inline UTextOffset lastIndexOf(const UnicodeString& text, UTextOffset start, int32_t length) const; inline UTextOffset lastIndexOf(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength, UTextOffset start, int32_t length) const; inline UTextOffset lastIndexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start) const; inline UTextOffset lastIndexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start, int32_t length) const; UTextOffset lastIndexOf(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength, UTextOffset start, int32_t length) const; inline UTextOffset lastIndexOf(UChar c) const; inline UTextOffset lastIndexOf(UChar c, UTextOffset start) const; inline UTextOffset lastIndexOf(UChar c, UTextOffset start, int32_t length) const; /* Character access */ inline UChar charAt(UTextOffset offset) const; inline UChar operator [] (UTextOffset offset) const; /* Substring extraction */ inline void extract(UTextOffset start, int32_t length, UChar *dst, UTextOffset dstStart = 0) const; inline void extract(UTextOffset start, int32_t length, UnicodeString& target) const; inline void extractBetween(UTextOffset start, UTextOffset limit, UChar *dst, UTextOffset dstStart = 0) const; inline void extractBetween(UTextOffset start, UTextOffset limit, UnicodeString& target) const; int32_t extract(UTextOffset start, int32_t length, char *dst, const char *codepage = 0) const; /* Length operations */ inline int32_t length(void) const; inline bool_t empty(void) const; /* Other operations */ inline int32_t hashCode(void) const; inline bool_t isBogus(void) const; //======================================== // Write operations //======================================== /* Assignment operations */ UnicodeString& operator= (const UnicodeString& srcText); inline UnicodeString& operator= (UChar ch); inline UnicodeString& setTo(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& setTo(const UnicodeString& srcText); inline UnicodeString& setTo(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& setTo(const UChar *srcChars, int32_t srcLength); UnicodeString& setTo(UChar srcChar); UnicodeString& setCharAt(UTextOffset offset, UChar ch); /* Append operations */ inline UnicodeString& operator+= (UChar ch); inline UnicodeString& operator+= (const UnicodeString& srcText); inline UnicodeString& append(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& append(const UnicodeString& srcText); inline UnicodeString& append(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& append(const UChar *srcChars, int32_t srcLength); inline UnicodeString& append(UChar srcChar); /* Insert operations */ inline UnicodeString& insert(UTextOffset start, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& insert(UTextOffset start, const UnicodeString& srcText); inline UnicodeString& insert(UTextOffset start, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& insert(UTextOffset start, const UChar *srcChars, int32_t srcLength); inline UnicodeString& insert(UTextOffset start, UChar srcChar); /* Replace operations */ UnicodeString& replace(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength); UnicodeString& replace(UTextOffset start, int32_t length, const UnicodeString& srcText); UnicodeString& replace(UTextOffset start, int32_t length, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength); inline UnicodeString& replace(UTextOffset start, int32_t length, const UChar *srcChars, int32_t srcLength); inline UnicodeString& replace(UTextOffset start, int32_t length, UChar srcChar); inline UnicodeString& replaceBetween(UTextOffset start, UTextOffset limit, const UnicodeString& srcText); inline UnicodeString& replaceBetween(UTextOffset start, UTextOffset limit, const UnicodeString& srcText, UTextOffset srcStart, UTextOffset srcLimit); virtual void handleReplaceBetween(UTextOffset start, UTextOffset limit, const UnicodeString& text); /* Search and replace operations */ inline UnicodeString& findAndReplace(const UnicodeString& oldText, const UnicodeString& newText); inline UnicodeString& findAndReplace(UTextOffset start, int32_t length, const UnicodeString& oldText, const UnicodeString& newText); UnicodeString& findAndReplace(UTextOffset start, int32_t length, const UnicodeString& oldText, UTextOffset oldStart, int32_t oldLength, const UnicodeString& newText, UTextOffset newStart, int32_t newLength); /* Remove operations */ inline UnicodeString& remove(void); inline UnicodeString& remove(UTextOffset start, int32_t length = LONG_MAX); inline UnicodeString& removeBetween(UTextOffset start, UTextOffset limit = LONG_MAX); /* Length operations */ inline bool_t padLeading(int32_t targetLength, UChar padChar = 0x0020); inline bool_t padTrailing(int32_t targetLength, UChar padChar = 0x0020); inline bool_t truncate(int32_t targetLength); inline UnicodeString& trim(void); /* Miscellaneous operations */ inline UnicodeString& reverse(void); inline UnicodeString& reverse(UTextOffset start, int32_t length); UnicodeString& toUpper(void); UnicodeString& toUpper(const Locale& locale); UnicodeString& toLower(void); UnicodeString& toLower(const Locale& locale); //======================================== // Constructors //======================================== UnicodeString(); UnicodeString(int32_t capacity); UnicodeString(UChar ch); UnicodeString(const UChar *text); UnicodeString(const UChar *text, int32_t textLength); UnicodeString(bool_t isTerminated, UChar *text, int32_t textLength); UnicodeString(const char *codepageData, const char *codepage = 0); UnicodeString(const char *codepageData, int32_t dataLength, const char *codepage = 0); inline UnicodeString(const UnicodeString& that); ~UnicodeString(); /* Miscellaneous operations */ int32_t numDisplayCells(UTextOffset start = 0, int32_t length = LONG_MAX, bool_t asian = TRUE) const; UCharReference operator[] (UTextOffset pos); // {sfb} remove these later? /* Hack to avoid circular dependencies */ // UnicodeString& toUpper(); // UnicodeString& toLower(); //======================================== // Implementation methods //======================================== private: inline int8_t doCompare(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const; int8_t doCompare(UTextOffset start, int32_t length, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const; UTextOffset doIndexOf(UChar c, UTextOffset start, int32_t length) const; UTextOffset doLastIndexOf(UChar c, UTextOffset start, int32_t length) const; void doExtract(UTextOffset start, int32_t length, UChar *dst, UTextOffset dstStart) const; inline void doExtract(UTextOffset start, int32_t length, UnicodeString& target) const; inline UChar doCharAt(UTextOffset offset) const; UnicodeString& doSetCharAt(UTextOffset offset, UChar c); UnicodeString& doReplace(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength); UnicodeString& doReplace(UTextOffset start, int32_t length, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength); UnicodeString& doReverse(UTextOffset start, int32_t length); // calculate hash code int32_t doHashCode(void); // get pointer to start of array inline UChar* getArrayStart(void); inline const UChar* getArrayStart(void) const; // get the "real" capacity of the array, adjusted for ref count inline int32_t getCapacity(void) const; // utility method to get around lack of exception handling void setToBogus(void); // Pin start and limit to acceptable values. void pinIndices(UTextOffset& start, int32_t& length) const; /* * Real constructor for converting from codepage data. * It assumes that it is called with !fRefCounted. * * If <code>codepage==0</code>, then the default converter * is used for the platform encoding. * If <code>codepage</code> is an empty string (<code>""</code>), * then a simple conversion is performed on the codepage-invariant * subset ("invariant characters") of the platform encoding. See utypes.h. */ void doCodepageCreate(const char *codepageData, int32_t dataLength, const char *codepage); // clones array if refCount > 1 void cloneArrayIfNeeded(void); // ref counting inline uint16_t addRef(void); inline uint16_t removeRef(void); inline uint16_t refCount(void) const; inline uint16_t setRefCount(uint16_t count); UChar fStackBuffer [ US_STACKBUF_SIZE ]; // buffer for small strings UChar *fArray; // the Unicode data int32_t fLength; // number characters in fArray int32_t fCapacity; // sizeof fArray int32_t fHashCode; // the hash code bool_t fRefCounted; // indicates if we own storage bool_t fBogus; // indicates if an operation failed // constants static const UChar fgInvalidUChar; // invalid UChar index static const int32_t kGrowSize; // grow size for this buffer static const int32_t kInvalidHashCode; // invalid hash code static const int32_t kEmptyHashCode; // hash code for empty string // statics inline static int32_t allocation(int32_t minSize); // allocation algorithm inline static UChar* allocate(int32_t minSize, // allocate buffer >= minSize int32_t& actualSize); // default converter cache static UConverter* getDefaultConverter(UErrorCode& status); static void releaseDefaultConverter(UConverter *converter); static UConverter *fgDefaultConverter; friend class UnicodeStringStreamer; public: //======================================== // Deprecated API //======================================== /* size() -> length() * @deprecated */ inline int32_t size(void) const; // parameters reordered for consistency /* @deprecated */ inline UnicodeString& findAndReplace(const UnicodeString& oldText, const UnicodeString& newText, UTextOffset start, int32_t length); /* @deprecated */ inline void* operator new(size_t size); /* @deprecated */ inline void* operator new(size_t size, void *location); /* @deprecated */ inline void operator delete(void *location); //======================================== // Non-public API - will be removed! //======================================== /* @deprecated */ UnicodeString(UChar *buff, int32_t bufLength, int32_t buffCapacity); /* @deprecated */ const UChar* getUChars(void) const; /* @deprecated */ inline const UChar* getUniChars(void) const; /* @deprecated */ UChar* orphanStorage(void); }; //======================================== // Array copying //======================================== // Copy an array of UnicodeString OBJECTS (not pointers). inline void uprv_arrayCopy(const UnicodeString *src, UnicodeString *dst, int32_t count) { while(count-- > 0) *dst++ = *src++; } inline void uprv_arrayCopy(const UnicodeString *src, int32_t srcStart, UnicodeString *dst, int32_t dstStart, int32_t count) { uprv_arrayCopy(src+srcStart, dst+dstStart, count); } //======================================== // Inline members //======================================== inline UnicodeString::UnicodeString(const UnicodeString& that) : fArray(fStackBuffer), fLength(0), fCapacity(US_STACKBUF_SIZE), fRefCounted(FALSE), fHashCode(kEmptyHashCode), fBogus(FALSE) { *this = that; } //======================================== // Read-only alias methods //======================================== inline bool_t UnicodeString::operator== (const UnicodeString& text) const { if(isBogus()) { return text.isBogus(); } else { return !text.isBogus() && fLength == text.fLength && doCompare(0, fLength, text, 0, text.fLength) == 0; } } inline bool_t UnicodeString::operator!= (const UnicodeString& text) const { return (! operator==(text)); } inline bool_t UnicodeString::operator> (const UnicodeString& text) const { return doCompare(0, fLength, text, 0, text.fLength) == 1; } inline bool_t UnicodeString::operator< (const UnicodeString& text) const { return doCompare(0, fLength, text, 0, text.fLength) == -1; } inline bool_t UnicodeString::operator>= (const UnicodeString& text) const { return doCompare(0, fLength, text, 0, text.fLength) != -1; } inline bool_t UnicodeString::operator<= (const UnicodeString& text) const { return doCompare(0, fLength, text, 0, text.fLength) != 1; } inline int8_t UnicodeString::compare(const UnicodeString& text) const { return doCompare(0, fLength, text, 0, text.fLength); } inline int8_t UnicodeString::compare(UTextOffset start, int32_t length, const UnicodeString& srcText) const { return doCompare(start, length, srcText, 0, srcText.fLength); } inline int8_t UnicodeString::compare(const UChar *srcChars, int32_t srcLength) const { return doCompare(0, fLength, srcChars, 0, srcLength); } inline int8_t UnicodeString::compare(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const { return doCompare(start, length, srcText, srcStart, srcLength); } inline int8_t UnicodeString::compare(UTextOffset start, int32_t length, const UChar *srcChars) const { return doCompare(start, length, srcChars, 0, length); } inline int8_t UnicodeString::compare(UTextOffset start, int32_t length, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const { return doCompare(start, length, srcChars, srcStart, srcLength); } inline int8_t UnicodeString::compareBetween(UTextOffset start, UTextOffset limit, const UnicodeString& srcText, UTextOffset srcStart, UTextOffset srcLimit) const { return doCompare(start, limit - start, srcText, srcStart, srcLimit - srcStart); } inline int8_t UnicodeString::doCompare(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const { const UChar *srcChars; if(!srcText.isBogus()) { srcText.pinIndices(srcStart, srcLength); srcChars=srcText.getArrayStart(); } else { srcChars=0; } return doCompare(start, length, srcChars, srcStart, srcLength); } inline UTextOffset UnicodeString::indexOf(const UnicodeString& text) const { return indexOf(text, 0, text.fLength, 0, fLength); } inline UTextOffset UnicodeString::indexOf(const UnicodeString& text, UTextOffset start) const { return indexOf(text, 0, text.fLength, start, fLength - start); } inline UTextOffset UnicodeString::indexOf(const UnicodeString& text, UTextOffset start, int32_t length) const { return indexOf(text, 0, text.fLength, start, length); } inline UTextOffset UnicodeString::indexOf(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength, UTextOffset start, int32_t length) const { if(!srcText.isBogus()) { srcText.pinIndices(srcStart, srcLength); if(srcLength > 0) { return indexOf(srcText.getArrayStart(), srcStart, srcLength, start, length); } } return -1; } inline UTextOffset UnicodeString::indexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start) const { return indexOf(srcChars, 0, srcLength, start, fLength - start); } inline UTextOffset UnicodeString::indexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start, int32_t length) const { return indexOf(srcChars, 0, srcLength, start, length); } inline UTextOffset UnicodeString::indexOf(UChar c) const { return doIndexOf(c, 0, fLength); } inline UTextOffset UnicodeString::indexOf(UChar c, UTextOffset start) const { return doIndexOf(c, start, fLength - start); } inline UTextOffset UnicodeString::indexOf(UChar c, UTextOffset start, int32_t length) const { return doIndexOf(c, start, length); } inline UTextOffset UnicodeString::lastIndexOf(const UnicodeString& text) const { return lastIndexOf(text, 0, text.fLength, 0, fLength); } inline UTextOffset UnicodeString::lastIndexOf(const UnicodeString& text, UTextOffset start) const { return lastIndexOf(text, 0, text.fLength, start, fLength - start); } inline UTextOffset UnicodeString::lastIndexOf(const UnicodeString& text, UTextOffset start, int32_t length) const { return lastIndexOf(text, 0, text.fLength, start, length); } inline UTextOffset UnicodeString::lastIndexOf(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength, UTextOffset start, int32_t length) const { if(!srcText.isBogus()) { srcText.pinIndices(srcStart, srcLength); if(srcLength > 0) { return lastIndexOf(srcText.getArrayStart(), srcStart, srcLength, start, length); } } return -1; } inline UTextOffset UnicodeString::lastIndexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start) const { return lastIndexOf(srcChars, 0, srcLength, start, fLength - start); } inline UTextOffset UnicodeString::lastIndexOf(const UChar *srcChars, int32_t srcLength, UTextOffset start, int32_t length) const { return lastIndexOf(srcChars, 0, srcLength, start, length); } inline UTextOffset UnicodeString::lastIndexOf(UChar c) const { return doLastIndexOf(c, 0, fLength); } inline UTextOffset UnicodeString::lastIndexOf(UChar c, UTextOffset start) const { return doLastIndexOf(c, start, fLength - start); } inline UTextOffset UnicodeString::lastIndexOf(UChar c, UTextOffset start, int32_t length) const { return doLastIndexOf(c, start, length); } inline bool_t UnicodeString::startsWith(const UnicodeString& text) const { return compare(0, text.fLength, text, 0, text.fLength) == 0; } inline bool_t UnicodeString::startsWith(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const { return doCompare(0, srcLength, srcText, srcStart, srcLength) == 0; } inline bool_t UnicodeString::startsWith(const UChar *srcChars, int32_t srcLength) const { return doCompare(0, srcLength, srcChars, 0, srcLength) == 0; } inline bool_t UnicodeString::startsWith(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const { return doCompare(0, srcLength, srcChars, srcStart, srcLength) == 0;} inline bool_t UnicodeString::endsWith(const UnicodeString& text) const { return doCompare(fLength - text.fLength, text.fLength, text, 0, text.fLength) == 0; } inline bool_t UnicodeString::endsWith(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) const { return doCompare(fLength - srcLength, srcLength, srcText, srcStart, srcLength) == 0; } inline bool_t UnicodeString::endsWith(const UChar *srcChars, int32_t srcLength) const { return doCompare(fLength - srcLength, srcLength, srcChars, 0, srcLength) == 0; } inline bool_t UnicodeString::endsWith(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) const { return doCompare(fLength - srcLength, srcLength, srcChars, srcStart, srcLength) == 0;} //======================================== // replace //======================================== inline UnicodeString& UnicodeString::replace(UTextOffset start, int32_t length, const UnicodeString& srcText) { return doReplace(start, length, srcText, 0, srcText.fLength); } inline UnicodeString& UnicodeString::replace(UTextOffset start, int32_t length, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) { return doReplace(start, length, srcText, srcStart, srcLength); } inline UnicodeString& UnicodeString::replace(UTextOffset start, int32_t length, const UChar *srcChars, int32_t srcLength) { return doReplace(start, length, srcChars, 0, srcLength); } inline UnicodeString& UnicodeString::replace(UTextOffset start, int32_t length, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) { return doReplace(start, length, srcChars, srcStart, srcLength); } inline UnicodeString& UnicodeString::replace(UTextOffset start, int32_t length, UChar srcChar) { return doReplace(start, length, &srcChar, 0, 1); } inline UnicodeString& UnicodeString::replaceBetween(UTextOffset start, UTextOffset limit, const UnicodeString& srcText) { return doReplace(start, limit - start, srcText, 0, srcText.fLength); } inline UnicodeString& UnicodeString::replaceBetween(UTextOffset start, UTextOffset limit, const UnicodeString& srcText, UTextOffset srcStart, UTextOffset srcLimit) { return doReplace(start, limit - start, srcText, srcStart, srcLimit - srcStart); } inline UnicodeString& UnicodeString::findAndReplace(const UnicodeString& oldText, const UnicodeString& newText) { return findAndReplace(0, fLength, oldText, 0, oldText.fLength, newText, 0, newText.fLength); } inline UnicodeString& UnicodeString::findAndReplace(UTextOffset start, int32_t length, const UnicodeString& oldText, const UnicodeString& newText) { return findAndReplace(start, length, oldText, 0, oldText.fLength, newText, 0, newText.fLength); } // ============================ // extract // ============================ inline void UnicodeString::doExtract(UTextOffset start, int32_t length, UnicodeString& target) const { target.replace(0, target.fLength, *this, start, length); } inline void UnicodeString::extract(UTextOffset start, int32_t length, UChar *dst, UTextOffset dstStart) const { doExtract(start, length, dst, dstStart); } inline void UnicodeString::extract(UTextOffset start, int32_t length, UnicodeString& target) const { doExtract(start, length, target); } inline void UnicodeString::extractBetween(UTextOffset start, UTextOffset limit, UChar *dst, UTextOffset dstStart) const { doExtract(start, limit - start, dst, dstStart); } inline void UnicodeString::extractBetween(UTextOffset start, UTextOffset limit, UnicodeString& target) const { doExtract(start, limit - start, target); } inline UChar UnicodeString::doCharAt(UTextOffset offset) const { if(offset < 0 || offset >= fLength) return fgInvalidUChar; // in ref-counted implementation, first char is ref count return fArray[ fRefCounted ? offset + 1 : offset ]; } inline UChar UnicodeString::charAt(UTextOffset offset) const { return doCharAt(offset); } inline UChar UnicodeString::operator[] (UTextOffset offset) const { return doCharAt(offset); } inline bool_t UnicodeString::empty() const { return fLength == 0; } //======================================== // Read-only implementation methods //======================================== inline int32_t UnicodeString::length() const { return fLength; } inline int32_t UnicodeString::hashCode() const { return (fHashCode == kInvalidHashCode ? ((UnicodeString*)this)->doHashCode() : fHashCode); } //======================================== // Write alias methods //======================================== inline UnicodeString& UnicodeString::operator= (UChar ch) { return doReplace(0, fLength, &ch, 0, 1); } inline UnicodeString& UnicodeString::setTo(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) { return doReplace(0, fLength, srcText, srcStart, srcLength); } inline UnicodeString& UnicodeString::setTo(const UnicodeString& srcText) { return doReplace(0, fLength, srcText, 0, srcText.fLength); } inline UnicodeString& UnicodeString::setTo(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) { return doReplace(0, fLength, srcChars, srcStart, srcLength); } inline UnicodeString& UnicodeString::setTo(const UChar *srcChars, int32_t srcLength) { return doReplace(0, fLength, srcChars, 0, srcLength); } inline UnicodeString& UnicodeString::setTo(UChar srcChar) { return doReplace(0, fLength, &srcChar, 0, 1); } inline UnicodeString& UnicodeString::operator+= (UChar ch) { return doReplace(fLength, 0, &ch, 0, 1); } inline UnicodeString& UnicodeString::operator+= (const UnicodeString& srcText) { return doReplace(fLength, 0, srcText, 0, srcText.fLength); } inline UnicodeString& UnicodeString::append(const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) { return doReplace(fLength, 0, srcText, srcStart, srcLength); } inline UnicodeString& UnicodeString::append(const UnicodeString& srcText) { return doReplace(fLength, 0, srcText, 0, srcText.fLength); } inline UnicodeString& UnicodeString::append(const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) { return doReplace(fLength, 0, srcChars, srcStart, srcLength); } inline UnicodeString& UnicodeString::append(const UChar *srcChars, int32_t srcLength) { return doReplace(fLength, 0, srcChars, 0, srcLength); } inline UnicodeString& UnicodeString::append(UChar srcChar) { return doReplace(fLength, 0, &srcChar, 0, 1); } inline UnicodeString& UnicodeString::insert(UTextOffset start, const UnicodeString& srcText, UTextOffset srcStart, int32_t srcLength) { return doReplace(start, 0, srcText, srcStart, srcLength); } inline UnicodeString& UnicodeString::insert(UTextOffset start, const UnicodeString& srcText) { return doReplace(start, 0, srcText, 0, srcText.fLength); } inline UnicodeString& UnicodeString::insert(UTextOffset start, const UChar *srcChars, UTextOffset srcStart, int32_t srcLength) { return doReplace(start, 0, srcChars, srcStart, srcLength); } inline UnicodeString& UnicodeString::insert(UTextOffset start, const UChar *srcChars, int32_t srcLength) { return doReplace(start, 0, srcChars, 0, srcLength); } inline UnicodeString& UnicodeString::insert(UTextOffset start, UChar srcChar) { return doReplace(start, 0, &srcChar, 0, 1); } inline UnicodeString& UnicodeString::remove(UTextOffset start, int32_t length) { return doReplace(start, length, 0, 0, 0); } inline UnicodeString& UnicodeString::remove() { return doReplace(0, fLength, 0, 0, 0); } inline UnicodeString& UnicodeString::removeBetween(UTextOffset start, UTextOffset limit) { return doReplace(start, limit - start, 0, 0, 0); } inline bool_t UnicodeString::padLeading(int32_t targetLength, UChar padChar) { if(fLength >= targetLength) return FALSE; else { int32_t len = fLength; for(int32_t i = 0; i < targetLength - len; ++i) doReplace(0, 0, &padChar, 0, 1); return TRUE; } } inline bool_t UnicodeString::padTrailing(int32_t targetLength, UChar padChar) { if(fLength >= targetLength) return FALSE; else { int32_t len = fLength; for(int32_t i = 0; i < targetLength - len; ++i) doReplace(fLength, 0, &padChar, 0, 1); return TRUE; } } inline bool_t UnicodeString::truncate(int32_t targetLength) { if(fLength < targetLength) return FALSE; else { doReplace(targetLength, fLength - targetLength, 0, 0, 0); return TRUE; } } inline UnicodeString& UnicodeString::trim() { int32_t wsStart = 0; int32_t wsEnd = 0; UTextOffset start = 0; UTextOffset limit = fLength; UChar c = doCharAt(start); while(start < limit && (c == 0x0020 || Unicode::getType(c) == Unicode::SPACE_SEPARATOR)) { ++wsStart; c = doCharAt(++start); } c = charAt(--limit); while(limit > start && (c == 0x0020 || Unicode::getType(c) == Unicode::SPACE_SEPARATOR)) { ++wsEnd; c = doCharAt(--limit); } doReplace(0, wsStart, 0, 0, 0); doReplace(fLength - wsEnd, wsEnd, 0, 0, 0); return *this; } inline UnicodeString& UnicodeString::reverse() { return doReverse(0, fLength); } inline UnicodeString& UnicodeString::reverse(UTextOffset start, int32_t length) { return doReverse(start, length); } //======================================== // Write implementation methods //======================================== inline bool_t UnicodeString::isBogus() const { return fBogus; } //======================================== // Privates //======================================== inline UChar* UnicodeString::getArrayStart() { return (fRefCounted ? fArray + 1 : fArray); } inline const UChar* UnicodeString::getArrayStart() const { return (fRefCounted ? fArray + 1 : fArray); } inline int32_t UnicodeString::getCapacity() const { return (fRefCounted ? fCapacity - 1 : fCapacity); } inline uint16_t UnicodeString::addRef() { return ++(fArray[0]); } inline uint16_t UnicodeString::removeRef() { return --(fArray[0]); } inline uint16_t UnicodeString::refCount() const { return fArray[0]; } inline uint16_t UnicodeString::setRefCount(uint16_t count) { fRefCounted = TRUE; return (fArray[0] = count); } // deprecated API - remove later inline int32_t UnicodeString::size() const { return fLength; } inline const UChar* UnicodeString::getUniChars() const { return getUChars(); } inline UnicodeString& UnicodeString::findAndReplace(const UnicodeString& oldText, const UnicodeString& newText, UTextOffset start, int32_t length) { return findAndReplace(start, length, oldText, newText); } inline void* UnicodeString::operator new(size_t size) { return ::operator new(size); } inline void* UnicodeString::operator new(size_t size, void *location) { return location; } inline void UnicodeString::operator delete(void *location) { ::operator delete(location); } //======================================== // Static members //======================================== inline int32_t UnicodeString::allocation(int32_t minSize) { return minSize < kGrowSize ? kGrowSize : (minSize * 2 + kGrowSize) & ~(kGrowSize - 1); } inline UChar* UnicodeString::allocate(int32_t minSize, int32_t& actualSize) { actualSize = allocation(minSize); return new UChar[ actualSize ]; } //======================================== // class UCharReference //======================================== class UCharReference { public: UCharReference(); inline UCharReference(UnicodeString *string, UTextOffset pos); inline UCharReference(const UCharReference& that); ~UCharReference(); inline UCharReference& operator= (const UCharReference& that); inline UCharReference& operator= (UChar c); inline operator UChar(); private: UnicodeString *fString; UTextOffset fPos; }; //======================================== // Inline members //======================================== inline UCharReference::UCharReference(UnicodeString *string, UTextOffset pos) : fString(string), fPos(pos) {} inline UCharReference::UCharReference(const UCharReference& that) { this->operator=(that); } inline UCharReference::~UCharReference() {} inline UCharReference& UCharReference::operator= (const UCharReference& that) { fString->setCharAt(fPos, that.fString->charAt(that.fPos)); return *this; } inline UCharReference& UCharReference::operator= (UChar c) { fString->setCharAt(fPos, c); return *this; } inline UCharReference::operator UChar() { return fString->charAt(fPos); } #endif