(file) Return to String.cpp CVS log (file) (dir) Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/String.cpp between version 1.53 and 1.111.6.5

version 1.53, 2002/08/27 23:38:44 version 1.111.6.5, 2005/10/11 01:13:01
Line 1 
Line 1 
 //%/////////////////////////////////////////////////////////////////////////////  //%2005////////////////////////////////////////////////////////////////////////
 // //
 // Copyright (c) 2000, 2001, 2002 BMC Software, Hewlett-Packard Company, IBM,  // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
 // The Open Group, Tivoli Systems  // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
   // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
   // IBM Corp.; EMC Corporation, The Open Group.
   // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
   // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
   // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
   // EMC Corporation; VERITAS Software Corporation; The Open Group.
 // //
 // Permission is hereby granted, free of charge, to any person obtaining a copy // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to // of this software and associated documentation files (the "Software"), to
Line 23 
Line 29 
 // //
 // Author: Mike Brasher (mbrasher@bmc.com) // Author: Mike Brasher (mbrasher@bmc.com)
 // //
 // Modified By: Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com)  // Modified By:
   //     Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com)
   //     Josephine Eskaline Joyce, IBM (jojustin@in.ibm.com) for Bug#3297
   //     David Dillard, VERITAS Software Corp. (david.dillard@veritas.com)
   //     Mike Brasher (mike-brasher@austin.rr.com)
 // //
 //%///////////////////////////////////////////////////////////////////////////// //%/////////////////////////////////////////////////////////////////////////////
  
   #include <cassert>
 #include <cctype>  
 #include "String.h"  
 #include "Array.h"  
 #include "InternalException.h" #include "InternalException.h"
 #include <iostream>  #include "CommonUTF.h"
   #include "MessageLoader.h"
 PEGASUS_USING_STD;  #include "StringRep.h"
   
   #ifdef PEGASUS_HAS_ICU
   #include <unicode/ustring.h>
   #include <unicode/uchar.h>
   #endif
  
 PEGASUS_NAMESPACE_BEGIN PEGASUS_NAMESPACE_BEGIN
  
 ///////////////////////////////////////////////////////////////////////////////  //==============================================================================
 // //
 // String  // Compile-time macros (undefined by default).
 // //
 ///////////////////////////////////////////////////////////////////////////////  //     PEGASUS_STRING_NO_THROW -- suppresses throwing of exceptions
   //
   //     PEGASUS_STRING_NO_UTF8 -- don't generate slower UTF8 code.
   //
   //==============================================================================
  
 const String String::EMPTY = String();  //==============================================================================
   //
   // File-scope definitions:
   //
   //==============================================================================
  
 Uint32 _strnlen(const char* str, Uint32 n)  const Uint8 _to_upper_tbl[256] =
 { {
     if (!str)      0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,
         throw NullPointer();      0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F,
       0x10,0x11,0x12,0x13,0x14,0x15,0x16,0x17,
       0x18,0x19,0x1A,0x1B,0x1C,0x1D,0x1E,0x1F,
       0x20,0x21,0x22,0x23,0x24,0x25,0x26,0x27,
       0x28,0x29,0x2A,0x2B,0x2C,0x2D,0x2E,0x2F,
       0x30,0x31,0x32,0x33,0x34,0x35,0x36,0x37,
       0x38,0x39,0x3A,0x3B,0x3C,0x3D,0x3E,0x3F,
       0x40,0x41,0x42,0x43,0x44,0x45,0x46,0x47,
       0x48,0x49,0x4A,0x4B,0x4C,0x4D,0x4E,0x4F,
       0x50,0x51,0x52,0x53,0x54,0x55,0x56,0x57,
       0x58,0x59,0x5A,0x5B,0x5C,0x5D,0x5E,0x5F,
       0x60,0x41,0x42,0x43,0x44,0x45,0x46,0x47,
       0x48,0x49,0x4A,0x4B,0x4C,0x4D,0x4E,0x4F,
       0x50,0x51,0x52,0x53,0x54,0x55,0x56,0x57,
       0x58,0x59,0x5A,0x7B,0x7C,0x7D,0x7E,0x7F,
       0x80,0x81,0x82,0x83,0x84,0x85,0x86,0x87,
       0x88,0x89,0x8A,0x8B,0x8C,0x8D,0x8E,0x8F,
       0x90,0x91,0x92,0x93,0x94,0x95,0x96,0x97,
       0x98,0x99,0x9A,0x9B,0x9C,0x9D,0x9E,0x9F,
       0xA0,0xA1,0xA2,0xA3,0xA4,0xA5,0xA6,0xA7,
       0xA8,0xA9,0xAA,0xAB,0xAC,0xAD,0xAE,0xAF,
       0xB0,0xB1,0xB2,0xB3,0xB4,0xB5,0xB6,0xB7,
       0xB8,0xB9,0xBA,0xBB,0xBC,0xBD,0xBE,0xBF,
       0xC0,0xC1,0xC2,0xC3,0xC4,0xC5,0xC6,0xC7,
       0xC8,0xC9,0xCA,0xCB,0xCC,0xCD,0xCE,0xCF,
       0xD0,0xD1,0xD2,0xD3,0xD4,0xD5,0xD6,0xD7,
       0xD8,0xD9,0xDA,0xDB,0xDC,0xDD,0xDE,0xDF,
       0xE0,0xE1,0xE2,0xE3,0xE4,0xE5,0xE6,0xE7,
       0xE8,0xE9,0xEA,0xEB,0xEC,0xED,0xEE,0xEF,
       0xF0,0xF1,0xF2,0xF3,0xF4,0xF5,0xF6,0xF7,
       0xF8,0xF9,0xFA,0xFB,0xFC,0xFD,0xFE,0xFF,
   };
  
     for (Uint32 i=0; i<n; i++)  const Uint8 _to_lower_tbl[256] =
     {     {
         if (!*str)      0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,
       0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F,
       0x10,0x11,0x12,0x13,0x14,0x15,0x16,0x17,
       0x18,0x19,0x1A,0x1B,0x1C,0x1D,0x1E,0x1F,
       0x20,0x21,0x22,0x23,0x24,0x25,0x26,0x27,
       0x28,0x29,0x2A,0x2B,0x2C,0x2D,0x2E,0x2F,
       0x30,0x31,0x32,0x33,0x34,0x35,0x36,0x37,
       0x38,0x39,0x3A,0x3B,0x3C,0x3D,0x3E,0x3F,
       0x40,0x61,0x62,0x63,0x64,0x65,0x66,0x67,
       0x68,0x69,0x6A,0x6B,0x6C,0x6D,0x6E,0x6F,
       0x70,0x71,0x72,0x73,0x74,0x75,0x76,0x77,
       0x78,0x79,0x7A,0x5B,0x5C,0x5D,0x5E,0x5F,
       0x60,0x61,0x62,0x63,0x64,0x65,0x66,0x67,
       0x68,0x69,0x6A,0x6B,0x6C,0x6D,0x6E,0x6F,
       0x70,0x71,0x72,0x73,0x74,0x75,0x76,0x77,
       0x78,0x79,0x7A,0x7B,0x7C,0x7D,0x7E,0x7F,
       0x80,0x81,0x82,0x83,0x84,0x85,0x86,0x87,
       0x88,0x89,0x8A,0x8B,0x8C,0x8D,0x8E,0x8F,
       0x90,0x91,0x92,0x93,0x94,0x95,0x96,0x97,
       0x98,0x99,0x9A,0x9B,0x9C,0x9D,0x9E,0x9F,
       0xA0,0xA1,0xA2,0xA3,0xA4,0xA5,0xA6,0xA7,
       0xA8,0xA9,0xAA,0xAB,0xAC,0xAD,0xAE,0xAF,
       0xB0,0xB1,0xB2,0xB3,0xB4,0xB5,0xB6,0xB7,
       0xB8,0xB9,0xBA,0xBB,0xBC,0xBD,0xBE,0xBF,
       0xC0,0xC1,0xC2,0xC3,0xC4,0xC5,0xC6,0xC7,
       0xC8,0xC9,0xCA,0xCB,0xCC,0xCD,0xCE,0xCF,
       0xD0,0xD1,0xD2,0xD3,0xD4,0xD5,0xD6,0xD7,
       0xD8,0xD9,0xDA,0xDB,0xDC,0xDD,0xDE,0xDF,
       0xE0,0xE1,0xE2,0xE3,0xE4,0xE5,0xE6,0xE7,
       0xE8,0xE9,0xEA,0xEB,0xEC,0xED,0xEE,0xEF,
       0xF0,0xF1,0xF2,0xF3,0xF4,0xF5,0xF6,0xF7,
       0xF8,0xF9,0xFA,0xFB,0xFC,0xFD,0xFE,0xFF,
   };
   
   // Converts 16-bit characters to upper case.
   inline Uint16 _to_upper(Uint16 x)
         {         {
             return i;      return (x & 0xFF00) ? x : _to_upper_tbl[x];
         }         }
   
   // Converts 16-bit characters to lower case.
   inline Uint16 _to_lower(Uint16 x)
   {
       return (x & 0xFF00) ? x : _to_lower_tbl[x];
     }     }
  
     return n;  // Rounds x to the next power of two (or just returns 8 if x < 8).
   static Uint32 _roundUpToPow2(Uint32 x)
   {
       if (x < 8)
           return 8;
   
       x--;
       x |= (x >> 1);
       x |= (x >> 2);
       x |= (x >> 4);
       x |= (x >> 8);
       x |= (x >> 16);
       x++;
   
       return x;
 } }
  
 Uint32 _strnlen(const Char16* str, Uint32 n)  template<class P, class Q>
   static void _copy(P* p, const Q* q, size_t n)
 { {
     if (!str)      // Use loop unrolling.
         throw NullPointer();  
  
     for (Uint32 i=0; i<n; i++)      while (n >= 8)
     {     {
         if (!*str)          p[0] = q[0];
           p[1] = q[1];
           p[2] = q[2];
           p[3] = q[3];
           p[4] = q[4];
           p[5] = q[5];
           p[6] = q[6];
           p[7] = q[7];
           p += 8;
           q += 8;
           n -= 8;
       }
   
       while (n >= 4)
         {         {
             return i;          p[0] = q[0];
           p[1] = q[1];
           p[2] = q[2];
           p[3] = q[3];
           p += 4;
           q += 4;
           n -= 4;
         }         }
   
       while (n--)
           *p++ = *q++;
     }     }
  
     return n;  static Uint16* _find(const Uint16* s, size_t n, Uint16 c)
   {
       while (n >= 4)
       {
           if (s[0] == c)
               return (Uint16*)s;
           if (s[1] == c)
               return (Uint16*)&s[1];
           if (s[2] == c)
               return (Uint16*)&s[2];
           if (s[3] == c)
               return (Uint16*)&s[3];
   
           n -= 4;
           s += 4;
 } }
  
 inline Uint32 _StrLen(const char* str)      if (n)
 { {
     if (!str)          if (*s == c)
         throw NullPointer();              return (Uint16*)s;
           s++;
           n--;
       }
   
       if (n)
       {
           if (*s == c)
               return (Uint16*)s;
           s++;
           n--;
       }
   
       if (n && *s == c)
           return (Uint16*)s;
  
     return strlen(str);      // Not found!
       return 0;
 } }
  
 inline Uint32 _StrLen(const Char16* str)  static int _compare(const Uint16* s1, const Uint16* s2)
 { {
     if (!str)      while (*s1 && *s2)
         throw NullPointer();      {
           int r = *s1++ - *s2++;
  
     Uint32 n = 0;          if (r)
               return r;
       }
  
     while (*str++)      if (*s2)
         n++;          return -1;
       else if (*s1)
           return 1;
  
     return n;      return 0;
 } }
  
 class StringRep  static int _compare_no_utf8(const Uint16* s1, const char* s2)
 { {
 public:      Uint16 c1;
     StringRep()      Uint16 c2;
     {}  
     StringRep(const StringRep& r)  
         : c16a(r.c16a)  
     {}  
     StringRep(const Char16* str)  
         : c16a(str, _StrLen(str) + 1)  
     {}  
  
     Array<Char16> c16a;      do
 };      {
           c1 = *s1++;
           c2 = *s2++;
  
 String::String()          if (c1 == 0)
               return c1 - c2;
       }
       while (c1 == c2);
   
       return c1 - c2;
   }
   
   static int _compare(const Uint16* s1, const Uint16* s2, size_t n)
 { {
     _rep = new StringRep;      // This should only be called when s1 and s2 have the same length.
     _rep->c16a.append('\0');  
       while (n-- && (*s1++ - *s2++) == 0)
           ;
   
       //
   
       return s1[-1] - s2[-1];
 } }
  
 String::String(const String& str)  static inline void _copy(Uint16* s1, const Uint16* s2, size_t n)
 { {
     _rep = new StringRep(*str._rep);      memcpy(s1, s2, n * sizeof(Uint16));
 } }
  
 String::String(const String& str, Uint32 n)  void String_throw_out_of_bounds()
 { {
     _rep = new StringRep;      throw IndexOutOfBoundsException();
     assign(str.getData(), n);  
 } }
  
 String::String(const Char16* str)  #ifdef PEGASUS_STRING_NO_THROW
   # define _check_null_pointer(ARG) /* empty */
   #else
   template<class T>
   inline void _check_null_pointer(const T* ptr)
 { {
     _rep = new StringRep(str);      if (!ptr)
           throw NullPointer();
 } }
   #endif
  
 String::String(const Char16* str, Uint32 n)  static size_t _copy_from_utf8(Uint16* dest, const char* src, size_t n)
 { {
     _rep = new StringRep;      Uint16* p = dest;
     assign(str, n);      const Uint8* q = (const Uint8*)src;
   
       // Process leading 7-bit ASCII characters (to avoid UTF8 overhead later).
       // Use loop-unrolling.
   
       while (n >=8 && ((q[0]|q[1]|q[2]|q[3]|q[4]|q[5]|q[6]|q[7]) & 0x80) == 0)
       {
           p[0] = q[0];
           p[1] = q[1];
           p[2] = q[2];
           p[3] = q[3];
           p[4] = q[4];
           p[5] = q[5];
           p[6] = q[6];
           p[7] = q[7];
           p += 8;
           q += 8;
           n -= 8;
 } }
  
 String::String(const char* str)      while (n >=4 && ((q[0]|q[1]|q[2]|q[3]) & 0x80) == 0)
 { {
     _rep = new StringRep;          p[0] = q[0];
     assign(str);          p[1] = q[1];
           p[2] = q[2];
           p[3] = q[3];
           p += 4;
           q += 4;
           n -= 4;
 } }
  
 String::String(const char* str, Uint32 n)      switch (n)
       {
           case 0:
               return p - dest;
           case 1:
               if (q[0] < 128)
               {
                   p[0] = q[0];
                   return p + 1 - dest;
               }
               break;
           case 2:
               if (((q[0]|q[1]) & 0x80) == 0)
 { {
     _rep = new StringRep;                  p[0] = q[0];
     assign(str, n);                  p[1] = q[1];
                   return p + 2 - dest;
               }
               break;
           case 3:
               if (((q[0]|q[1]|q[2]) & 0x80) == 0)
               {
                   p[0] = q[0];
                   p[1] = q[1];
                   p[2] = q[2];
                   return p + 3 - dest;
               }
               break;
 } }
  
 String::~String()      // Process remaining characters.
   
       while (n)
       {
           // Optimize for 7-bit ASCII case.
   
           if (*q < 128)
 { {
     delete _rep;              *p++ = *q++;
               n--;
 } }
           else
           {
               Uint8 c = UTF_8_COUNT_TRAIL_BYTES(*q) + 1;
  
 String& String::operator=(const String& str)              if (c > n || !isValid_U8(q, c) ||
                   UTF8toUTF16(&q, q + c, &p, p + n) != 0)
 { {
     return assign(str);                  MessageLoaderParms parms("Common.String.BAD_UTF8",
                       "The byte sequence starting at index $0 "
                       "is not valid UTF-8 encoding.",
                        q - (const Uint8*)src);
                   throw Exception(parms);
 } }
  
 String& String::assign(const String& str)              n -= c;
           }
       }
   
       return p - dest;
   }
   
   // Note: dest must be at least three times src (plus an extra byte for
   // terminator).
   static inline size_t _copy_to_utf8(char* dest, const Uint16* src, size_t n)
 { {
     _rep->c16a = str._rep->c16a;      const Uint16* q = src;
     return *this;      Uint8* p = (Uint8*)dest;
   
       while (n >= 4 && q[0] < 128 && q[1] < 128 && q[2] < 128 && q[3] < 128)
       {
           p[0] = q[0];
           p[1] = q[1];
           p[2] = q[2];
           p[3] = q[3];
           p += 4;
           q += 4;
           n -= 4;
 } }
  
 String& String::assign(const Char16* str)      switch (n)
 { {
     _rep->c16a.clear();          case 0:
     _rep->c16a.append(str, _StrLen(str) + 1);              return p - (Uint8*)dest;
     return *this;          case 1:
               if (q[0] < 128)
               {
                   p[0] = q[0];
                   return p + 1 - (Uint8*)dest;
               }
               break;
           case 2:
               if (q[0] < 128 && q[1] < 128)
               {
                   p[0] = q[0];
                   p[1] = q[1];
                   return p + 2 - (Uint8*)dest;
               }
               break;
           case 3:
               if (q[0] < 128 && q[1] < 128 && q[2] < 128)
               {
                   p[0] = q[0];
                   p[1] = q[1];
                   p[2] = q[2];
                   return p + 3 - (Uint8*)dest;
               }
               break;
 } }
  
 String& String::assign(const Char16* str, Uint32 n)      // If this line was reached, there must be characters greater than 128.
   
       UTF16toUTF8(&q, q + n, &p, p + 3 * n);
   
       return p - (Uint8*)dest;
   }
   
   static inline size_t _convert(Uint16* p, const char* q, size_t n)
 { {
     _rep->c16a.clear();  #ifdef PEGASUS_STRING_NO_UTF8
     Uint32 m = _strnlen(str, n);      _copy(p, q, n);
     _rep->c16a.append(str, m);      return n;
     _rep->c16a.append('\0');  #else
     return *this;      return _copy_from_utf8(p, q, n);
   #endif
 } }
  
 String& String::assign(const char* str)  //==============================================================================
   //
   // class CString
   //
   //==============================================================================
   
   CString::CString(const CString& cstr) : _rep(0)
 { {
     _rep->c16a.clear();      if (cstr._rep)
       {
           size_t n = strlen(cstr._rep) + 1;
           _rep = (char*)operator new(n);
           memcpy(_rep, cstr._rep, n);
       }
   }
  
     Uint32 n = strlen(str) + 1;  CString& CString::operator=(const CString& cstr)
     _rep->c16a.reserveCapacity(n);  {
       if (&cstr != this)
       {
           if (_rep)
           {
               operator delete(_rep);
               _rep = 0;
           }
  
     while (n--)          if (cstr._rep)
         _rep->c16a.append(*str++);          {
               size_t n = strlen(cstr._rep) + 1;
               _rep = (char*)operator new(n);
               memcpy(_rep, cstr._rep, n);
           }
       }
  
     return *this;     return *this;
 } }
  
 String& String::assign(const char* str, Uint32 n)  //==============================================================================
   //
   // class StringRep
   //
   //==============================================================================
   
   StringRep StringRep::_empty_rep;
   
   inline StringRep* StringRep::alloc(size_t cap)
 { {
     _rep->c16a.clear();      StringRep* rep = (StringRep*)::operator new(
           sizeof(StringRep) + cap * sizeof(Uint16));
       rep->cap = cap;
       Atomic_create(&rep->refs, 1);
  
     Uint32 _n = _strnlen(str, n);      return rep;
     _rep->c16a.reserveCapacity(_n + 1);  }
  
     while (_n--)  static inline void _reserve(StringRep*& rep, Uint32 cap)
         _rep->c16a.append(*str++);  {
       if (cap > rep->cap || Atomic_get(&rep->refs) != 1)
       {
           size_t n = _roundUpToPow2(cap);
           StringRep* new_rep = StringRep::alloc(n);
           new_rep->size = rep->size;
           _copy(new_rep->data, rep->data, rep->size + 1);
           StringRep::unref(rep);
           rep = new_rep;
       }
   }
  
     _rep->c16a.append('\0');  StringRep* StringRep::create(const Uint16* data, size_t size)
   {
       StringRep* rep = StringRep::alloc(size);
       rep->size = size;
       _copy(rep->data, data, size);
       rep->data[size] = '\0';
       return rep;
   }
  
     return *this;  StringRep* StringRep::copy_on_write(StringRep* rep)
   {
       // Return a new copy of rep. Release rep.
   
       StringRep* new_rep = StringRep::alloc(rep->size);
       new_rep->size = rep->size;
       _copy(new_rep->data, rep->data, rep->size);
       new_rep->data[new_rep->size] = '\0';
       StringRep::unref(rep);
       return new_rep;
 } }
  
 void String::clear()  StringRep* StringRep::create(const char* data, size_t size)
 { {
     _rep->c16a.clear();      StringRep* rep = StringRep::alloc(size);
     _rep->c16a.append('\0');      rep->size = _convert((Uint16*)rep->data, data, size);
       rep->data[rep->size] = '\0';
   
       return rep;
 } }
  
 void String::reserveCapacity(Uint32 capacity)  StringRep* StringRep::createASCII7(const char* data, size_t size)
 { {
     _rep->c16a.reserveCapacity(capacity + 1);      StringRep* rep = StringRep::alloc(size);
       _copy((Uint16*)rep->data, data, size);
       rep->data[rep->size = size] = '\0';
       return rep;
 } }
  
 Uint32 String::size() const  Uint32 StringRep::length(const Uint16* str)
 { {
     return _rep->c16a.size() - 1;      // Note: We could unroll this but it is rarely called.
   
       const Uint16* end = (Uint16*)str;
   
       while (*end++)
           ;
   
       return end - str - 1;
 } }
  
 const Char16* String::getData() const  //==============================================================================
   //
   // class String
   //
   //==============================================================================
   
   const String String::EMPTY;
   
   String::String(const String& str, Uint32 n)
 { {
     return _rep->c16a.getData();      _check_bounds(n, str._rep->size);
       _rep = StringRep::create(str._rep->data, n);
 } }
  
 char* String::allocateCString(Uint32 extraBytes, Boolean& truncatedCharacters) const  String::String(const Char16* str)
 { {
     truncatedCharacters = false;      _check_null_pointer(str);
     Uint32 n = size() + 1;      _rep = StringRep::create((Uint16*)str, StringRep::length((Uint16*)str));
     char* str = new char[n + extraBytes];  }
     char* p = str;  
     const Char16* q = getData();  
  
     for (Uint32 i = 0; i < n; i++)  String::String(const Char16* str, Uint32 n)
     {     {
         Uint16 c = *q++;      _check_null_pointer(str);
         *p++ = char(c);      _rep = StringRep::create((Uint16*)str, n);
   }
  
         if (c & 0xff00)  String::String(const char* str)
             truncatedCharacters = true;  {
       _check_null_pointer(str);
       _rep = StringRep::create(str, strlen(str));
     }     }
  
     return str;  String::String(const char* str, String::ASCII7Tag tag)
   {
       _check_null_pointer(str);
       _rep = StringRep::createASCII7(str, strlen(str));
 } }
  
 char* String::allocateCString(Uint32 extraBytes) const  String::String(const char* str, Uint32 n)
 { {
     Boolean truncatedCharacters = false;      _check_null_pointer(str);
     return allocateCString(extraBytes, truncatedCharacters);      _rep = StringRep::create(str, n);
 } }
  
 Char16& String::operator[](Uint32 index)  String::String(const char* str, size_t n, String::ASCII7Tag tag)
 { {
     if (index > size())      _check_null_pointer(str);
         throw IndexOutOfBoundsException();      _rep = StringRep::createASCII7(str, n);
   }
  
     return _rep->c16a[index];  String::String(const String& s1, const String& s2)
   {
       size_t n1 = s1._rep->size;
       size_t n2 = s2._rep->size;
       size_t n = n1 + n2;
       _rep = StringRep::alloc(n);
       _copy(_rep->data, s1._rep->data, n1);
       _copy(_rep->data + n1, s2._rep->data, n2);
       _rep->size = n;
       _rep->data[n] = '\0';
 } }
  
 const Char16 String::operator[](Uint32 index) const  String::String(const String& s1, const char* s2)
 { {
     if (index > size())      _check_null_pointer(s2);
         throw IndexOutOfBoundsException();      size_t n1 = s1._rep->size;
       size_t n2 = strlen(s2);
       _rep = StringRep::alloc(n1 + n2);
       _copy(_rep->data, s1._rep->data, n1);
       _rep->size = n1 + _convert((Uint16*)_rep->data + n1, s2, n2);
       _rep->data[_rep->size] = '\0';
   }
  
     return _rep->c16a[index];  String::String(const char* s1, const String& s2)
   {
       _check_null_pointer(s1);
       size_t n1 = strlen(s1);
       size_t n2 = s2._rep->size;
       _rep = StringRep::alloc(n1 + n2);
       _rep->size = n2 + _convert((Uint16*)_rep->data, s1, n1);
       _copy(_rep->data + n1, s2._rep->data, n2);
       _rep->data[_rep->size] = '\0';
 } }
  
 String& String::append(const Char16& c)  String& String::assign(const String& str)
 { {
     _rep->c16a.insert(_rep->c16a.size() - 1, c);      if (_rep != str._rep)
       {
           StringRep::unref(_rep);
           StringRep::ref(_rep = str._rep);
       }
   
     return *this;     return *this;
 } }
  
 String& String::append(const Char16* str, Uint32 n)  String& String::assign(const Char16* str, Uint32 n)
   {
       _check_null_pointer(str);
   
       if (n > _rep->cap || Atomic_get(&_rep->refs) != 1)
 { {
     Uint32 m = _strnlen(str, n);          StringRep::unref(_rep);
     _rep->c16a.reserveCapacity(_rep->c16a.size() + m);          _rep = StringRep::alloc(n);
     _rep->c16a.remove(_rep->c16a.size() - 1);      }
     _rep->c16a.append(str, m);  
     _rep->c16a.append('\0');      _rep->size = n;
       _copy(_rep->data, (Uint16*)str, n);
       _rep->data[n] = '\0';
   
     return *this;     return *this;
 } }
  
 String& String::append(const String& str)  String& String::assign(const char* str, Uint32 n)
 { {
     return append(str.getData(), str.size());      _check_null_pointer(str);
 }  
  
 void String::remove(Uint32 index, Uint32 size)      if (n > _rep->cap || Atomic_get(&_rep->refs) != 1)
 { {
     if (size == PEG_NOT_FOUND)          StringRep::unref(_rep);
         size = this->size() - index;          _rep = StringRep::alloc(n);
       }
  
     if (index + size > this->size())      _rep->size = _convert(_rep->data, str, n);
         throw IndexOutOfBoundsException();      _rep->data[_rep->size] = 0;
  
     if (size)      return *this;
         _rep->c16a.remove(index, size);  
 } }
  
 String String::subString(Uint32 index, Uint32 length) const  String& String::assignASCII7(const char* str, Uint32 n)
 { {
     if (index < size())      _check_null_pointer(str);
   
       if (n > _rep->cap || Atomic_get(&_rep->refs) != 1)
     {     {
         if (length == PEG_NOT_FOUND)          StringRep::unref(_rep);
             length = size() - index;          _rep = StringRep::alloc(n);
       }
   
       _copy(_rep->data, str, n);
       _rep->data[_rep->size = n] = 0;
  
         return String(getData() + index, length);      return *this;
   }
   
   void String::clear()
   {
       if (_rep->size)
       {
           if (Atomic_get(&_rep->refs) == 1)
           {
               _rep->size = 0;
               _rep->data[0] = '\0';
     }     }
     else     else
         return String();          {
               StringRep::unref(_rep);
               _rep = &StringRep::_empty_rep;
           }
       }
 } }
  
 Uint32 String::find(Char16 c) const  void String::reserveCapacity(Uint32 cap)
 { {
     const Char16* first = getData();      _reserve(_rep, cap);
   }
  
     for (const Char16* p = first; *p; p++)  CString String::getCString() const
     {     {
         if (*p == c)  #ifdef PEGASUS_STRING_NO_UTF8
             return  p - first;      char* str = (char*)operator new(_rep->size + 1);
       _copy(str, _rep->data, _rep->size);
       str[_rep->size] = '\0';
       return CString(str);
   #else
       Uint32 n = 3 * _rep->size;
       char* str = (char*)operator new(n + 1);
       size_t size = _copy_to_utf8(str, _rep->data, _rep->size);
       str[size] = '\0';
       return CString(str);
   #endif
     }     }
  
     return PEG_NOT_FOUND;  String& String::append(const Char16* str, Uint32 n)
   {
       _check_null_pointer(str);
   
       size_t old_size = _rep->size;
       size_t new_size = old_size + n;
       _reserve(_rep, new_size);
       _copy(_rep->data + old_size, (Uint16*)str, n);
       _rep->size = new_size;
       _rep->data[new_size] = '\0';
   
       return *this;
 } }
  
 Uint32 String::find(Uint32 index, Char16 c) const  String& String::append(const String& str)
 { {
     const Char16* data = getData();      return append((Char16*)str._rep->data, str._rep->size);
   }
  
     for (Uint32 i = index, n = size(); i < n; i++)  String& String::append(const char* str, Uint32 size)
     {     {
         if (data[i] == c)      _check_null_pointer(str);
             return i;  
       size_t old_size = _rep->size;
       size_t cap = old_size + size;
   
       _reserve(_rep, cap);
       _rep->size += _convert((Uint16*)_rep->data + old_size, str, size);
       _rep->data[_rep->size] = '\0';
   
       return *this;
     }     }
  
     return PEG_NOT_FOUND;  void String::remove(Uint32 index, Uint32 n)
   {
       if (n == PEG_NOT_FOUND)
           n = _rep->size - index;
   
       _check_bounds(index + n, _rep->size);
   
       if (Atomic_get(&_rep->refs) != 1)
           _rep = StringRep::copy_on_write(_rep);
   
       assert(index + n <= _rep->size);
   
       size_t rem = _rep->size - (index + n);
       Uint16* data = _rep->data;
   
       if (rem)
           memmove(data + index, data + index + n, rem * sizeof(Uint16));
   
       _rep->size -= n;
       data[_rep->size] = '\0';
 } }
  
 Uint32 String::find(const String& s) const  String String::subString(Uint32 index, Uint32 n) const
 { {
     const Char16* pSubStr = s.getData();      // Note: this implementation is very permissive but used for
     const Char16* pStr = getData();      // backwards compatibility.
     Uint32 subStrLen = s.size();  
     Uint32 strLen = size();  
  
     if (subStrLen > strLen)      if (index < _rep->size)
     {     {
         return PEG_NOT_FOUND;          if (n == PEG_NOT_FOUND || n > _rep->size - index)
               n = _rep->size - index;
   
           return String((Char16*)_rep->data + index, n);
     }     }
  
     // loop to find first char match      return String();
     Uint32 loc = 0;  
     for( ; loc <= (strLen-subStrLen); loc++)  
     {  
         if (*pStr++ == *pSubStr)  // match first char  
         {  
             // point to substr 2nd char  
             const Char16* p = pSubStr + 1;  
   
             // Test remaining chars for equal  
             Uint32 i = 1;  
             for (; i < subStrLen; i++)  
                 if (*pStr++ != *p++ )  
                     {pStr--; break;} // break from loop  
             if (i == subStrLen)  
                 return loc;  
         }         }
   
   Uint32 String::find(Char16 c) const
   {
       Uint16* p = (Uint16*)_find(_rep->data, _rep->size, c);
   
       if (p)
           return p - _rep->data;
   
       return PEG_NOT_FOUND;
     }     }
   
   Uint32 String::find(Uint32 index, Char16 c) const
   {
       _check_bounds(index, _rep->size);
   
       if (index >= _rep->size)
           return PEG_NOT_FOUND;
   
       Uint16* p = (Uint16*)_find(_rep->data + index, _rep->size - index, c);
   
       if (p)
           return p - _rep->data;
   
     return PEG_NOT_FOUND;     return PEG_NOT_FOUND;
 } }
  
 Uint32 String::reverseFind(Char16 c) const  Uint32 String_find_aux(
       const StringRep* _rep, const Char16* s, Uint32 n)
 { {
     const Char16* first = getData();      _check_null_pointer(s);
     const Char16* last = getData() + size();  
       const Uint16* data = _rep->data;
       size_t rem = _rep->size;
  
     while (last != first)      while (n <= rem)
     {     {
         if (*--last == c)          Uint16* p = (Uint16*)_find(data, rem, s[0]);
             return last - first;  
           if (!p)
               break;
   
           if (memcmp(p, s, n * sizeof(Uint16)) == 0)
               return p - _rep->data;
   
           p++;
           rem -= p - data;
           data = p;
     }     }
  
     return PEG_NOT_FOUND;     return PEG_NOT_FOUND;
 } }
  
 void String::toLower()  Uint32 String::find(const char* s) const
 { {
     for (Char16* p = &_rep->c16a[0]; *p; p++)      _check_null_pointer(s);
   
       // Note: could optimize away creation of temporary, but this is rarely
       // called.
       return find(String(s));
   }
   
   Uint32 String::reverseFind(Char16 c) const
     {     {
         if (*p <= PEGASUS_MAX_PRINTABLE_CHAR)      Uint16 x = c;
             *p = tolower(*p);      Uint16* p = _rep->data;
       Uint16* q = _rep->data + _rep->size;
   
       while (q != p)
       {
           if (*--q == x)
               return q - p;
     }     }
   
       return PEG_NOT_FOUND;
 } }
  
 int String::compare(const String& s1, const String& s2, Uint32 n)  void String::toLower()
 { {
     const Char16* s1c16 = s1.getData();  #ifdef PEGASUS_HAS_ICU
     const Char16* s2c16 = s2.getData();  
  
     while (n--)      if (InitializeICU::initICUSuccessful())
     {     {
         int r = *s1c16++ - *s2c16++;          if (Atomic_get(&_rep->refs) != 1)
                   _rep = StringRep::copy_on_write(_rep);
  
         if (r)          // This will do a locale-insensitive, but context-sensitive convert.
             return r;          // Since context-sensitive casing looks at adjacent chars, this
           // prevents optimizations where the us-ascii is converted before
           // calling ICU.
           // The string may shrink or expand after the convert.
   
           //// First calculate size of resulting string. u_strToLower() returns
           //// only the size when zero is passed as the destination size argument.
   
           UErrorCode err = U_ZERO_ERROR;
   
           int32_t new_size = u_strToLower(
               NULL, 0, (UChar*)_rep->data, _rep->size, NULL, &err);
   
           err = U_ZERO_ERROR;
   
           //// Reserve enough space for the result.
   
           if ((Uint32)new_size > _rep->cap)
               _reserve(_rep, new_size);
   
           //// Perform the conversion (overlapping buffers are allowed).
   
           u_strToLower((UChar*)_rep->data, new_size,
               (UChar*)_rep->data, _rep->size, NULL, &err);
   
           _rep->size = new_size;
           return;
     }     }
  
     return 0;  #endif /* PEGASUS_HAS_ICU */
   
       if (Atomic_get(&_rep->refs) != 1)
           _rep = StringRep::copy_on_write(_rep);
   
       Uint16* p = _rep->data;
       size_t n = _rep->size;
   
       for (; n--; p++)
       {
           if (!(*p & 0xFF00))
               *p = _to_lower(*p);
       }
 } }
  
 int String::compare(const String& s1, const String& s2)  void String::toUpper()
 { {
     const Char16* s1c16 = s1.getData();  #ifdef PEGASUS_HAS_ICU
     const Char16* s2c16 = s2.getData();  
  
     while (*s1c16 && *s2c16)      if (InitializeICU::initICUSuccessful())
     {     {
         int r = *s1c16++ - *s2c16++;          if (Atomic_get(&_rep->refs) != 1)
               _rep = StringRep::copy_on_write(_rep);
  
         if (r)          // This will do a locale-insensitive, but context-sensitive convert.
             return r;          // Since context-sensitive casing looks at adjacent chars, this
           // prevents optimizations where the us-ascii is converted before
           // calling ICU.
           // The string may shrink or expand after the convert.
   
           //// First calculate size of resulting string. u_strToUpper() returns
           //// only the size when zero is passed as the destination size argument.
   
           UErrorCode err = U_ZERO_ERROR;
   
           int32_t new_size = u_strToUpper(
               NULL, 0, (UChar*)_rep->data, _rep->size, NULL, &err);
   
           err = U_ZERO_ERROR;
   
           //// Reserve enough space for the result.
   
           if ((Uint32)new_size > _rep->cap)
               _reserve(_rep, new_size);
   
           //// Perform the conversion (overlapping buffers are allowed).
   
           u_strToUpper((UChar*)_rep->data, new_size,
               (UChar*)_rep->data, _rep->size, NULL, &err);
   
           _rep->size = new_size;
   
           return;
     }     }
  
     if (*s2c16)  #endif /* PEGASUS_HAS_ICU */
         return -1;  
     else if (*s1c16)  
         return 1;  
  
     return 0;      if (Atomic_get(&_rep->refs) != 1)
           _rep = StringRep::copy_on_write(_rep);
   
       Uint16* p = _rep->data;
       size_t n = _rep->size;
   
       for (; n--; p++)
           *p = _to_upper(*p);
 } }
  
 int String::compareNoCase(const String& s1, const String& s2)  int String::compare(const String& s1, const String& s2, Uint32 n)
 { {
     const Char16* _s1 = s1.getData();      assert(n <= s1._rep->size);
     const Char16* _s2 = s2.getData();      assert(n <= s2._rep->size);
  
     while (*_s1 && *_s2)      // Ignoring error in which n is greater than s1.size() or s2.size()
       return _compare(s1._rep->data, s2._rep->data, n);
   }
   
   int String::compare(const String& s1, const String& s2)
     {     {
         int r;      return _compare(s1._rep->data, s2._rep->data);
   }
  
         if (*_s1 <= PEGASUS_MAX_PRINTABLE_CHAR &&  int String::compare(const String& s1, const char* s2)
             *_s2 <= PEGASUS_MAX_PRINTABLE_CHAR)  
         {         {
             r = tolower(*_s1++) - tolower(*_s2++);      _check_null_pointer(s2);
   
   #ifdef PEGASUS_STRING_NO_UTF8
       return _compare_no_utf8(s1._rep->data, s2);
   #else
       // ATTN: optimize this!
       return String::compare(s1, String(s2));
   #endif
         }         }
         else  
   int String::compareNoCase(const String& str1, const String& str2)
         {         {
             r = *_s1++ - *_s2++;  #ifdef PEGASUS_HAS_ICU
   
       if (InitializeICU::initICUSuccessful())
       {
           return  u_strcasecmp(
               str1._rep->data, str2._rep->data, U_FOLD_CASE_DEFAULT);
         }         }
  
   #endif /* PEGASUS_HAS_ICU */
   
       const Uint16* s1 = str1._rep->data;
       const Uint16* s2 = str2._rep->data;
   
       while (*s1 && *s2)
       {
           int r = _to_lower(*s1++) - _to_lower(*s2++);
   
         if (r)         if (r)
             return r;             return r;
     }     }
  
     if (*_s2)      if (*s2)
         return -1;         return -1;
     else if (*_s1)      else if (*s1)
         return 1;         return 1;
  
     return 0;     return 0;
 } }
  
 Boolean String::equal(const String& str1, const String& str2)  Boolean String_equalNoCase_aux(const String& s1, const String& s2)
 { {
     return String::compare(str1, str2) == 0;  #ifdef PEGASUS_HAS_ICU
 }  
       return String::compareNoCase(s1, s2) == 0;
   
   #else /* PEGASUS_HAS_ICU */
   
       Uint16* p = (Uint16*)s1.getChar16Data();
       Uint16* q = (Uint16*)s2.getChar16Data();
       Uint32 n = s2.size();
  
 Boolean String::equalNoCase(const String& str1, const String& str2)      while (n >= 8)
       {
           if (((p[0] - q[0]) && (_to_upper(p[0]) - _to_upper(q[0]))) ||
               ((p[1] - q[1]) && (_to_upper(p[1]) - _to_upper(q[1]))) ||
               ((p[2] - q[2]) && (_to_upper(p[2]) - _to_upper(q[2]))) ||
               ((p[3] - q[3]) && (_to_upper(p[3]) - _to_upper(q[3]))) ||
               ((p[4] - q[4]) && (_to_upper(p[4]) - _to_upper(q[4]))) ||
               ((p[5] - q[5]) && (_to_upper(p[5]) - _to_upper(q[5]))) ||
               ((p[6] - q[6]) && (_to_upper(p[6]) - _to_upper(q[6]))) ||
               ((p[7] - q[7]) && (_to_upper(p[7]) - _to_upper(q[7]))))
 { {
     if (str1.size() != str2.size())  
         return false;         return false;
           }
  
     const Char16* p = str1.getData();          n -= 8;
     const Char16* q = str2.getData();          p += 8;
           q += 8;
     Uint32 n = str1.size();      }
  
     while (n--)      while (n >= 4)
     {     {
         if (*p <= PEGASUS_MAX_PRINTABLE_CHAR &&          if (((p[0] - q[0]) && (_to_upper(p[0]) - _to_upper(q[0]))) ||
             *q <= PEGASUS_MAX_PRINTABLE_CHAR)              ((p[1] - q[1]) && (_to_upper(p[1]) - _to_upper(q[1]))) ||
               ((p[2] - q[2]) && (_to_upper(p[2]) - _to_upper(q[2]))) ||
               ((p[3] - q[3]) && (_to_upper(p[3]) - _to_upper(q[3]))))
         {         {
             if (tolower(*p++) != tolower(*q++))  
                 return false;                 return false;
         }         }
         else if (*p++ != *q++)  
           n -= 4;
           p += 4;
           q += 4;
       }
   
       while (n--)
       {
           if (((p[0] - q[0]) && (_to_upper(p[0]) - _to_upper(q[0]))))
             return false;             return false;
   
           p++;
           q++;
     }     }
  
     return true;     return true;
   
   #endif /* PEGASUS_HAS_ICU */
 } }
  
   Boolean String::equalNoCase(const String& s1, const char* s2)
   {
       _check_null_pointer(s2);
  
 // ATTN-RK-P3-20020603: This code is not completely correct  #if defined(PEGASUS_HAS_ICU)
  // Wildcard String matching function that may be useful in the future  
 // The following code was provided by Bob Blair.  
   
 /* _StringMatch Match input MatchString against a GLOB style pattern  
        Note that MatchChar is the char type so that this source  
        in portable to different string types. This is an internal function  
   
   Results: The return value is 1 if string matches pattern, and  
         0 otherwise.  The matching operation permits the following  
         special characters in the pattern: *?\[] (see the manual  
         entry for details on what these mean).  
  
   Side effects: None.      return String::equalNoCase(s1, String(s2));
  */  
  
 /* MatchChar defined as a separate entity because this function source used  #elif defined(PEGASUS_STRING_NO_UTF8)
     elsewhere was an unsigned char *. Here we use Uint16 to  maintain 16 bit  
     size.  
 */  
 typedef Uint16 MatchChar;  
  
 inline Uint16 _ToLower(Uint16 ch)      const Uint16* p1 = (Uint16*)s1._rep->data;
 {      const char* p2 = s2;
     return ch <= PEGASUS_MAX_PRINTABLE_CHAR ? tolower(char(ch)) : ch;      size_t n = s1._rep->size;
 }  
  
 inline Boolean _Equal(MatchChar ch1, MatchChar ch2, int nocase)      while (n--)
 { {
     if (nocase)          if (!*p2)
         return _ToLower(ch1) == _ToLower(ch2);              return false;
     else  
         return ch1 == ch2;          if (_to_upper(*p1++) != _to_upper_tbl[int(*p2++)])
               return false;
 } }
  
       if (*p2)
           return false;
  
 static const MatchChar *      return true;
 _matchrange(const MatchChar *range, MatchChar c, int nocase)  
 {  
   const MatchChar *p = range;  
   const MatchChar *rstart = range + 1;  
   const MatchChar *rend = 0;  
   MatchChar compchar;  
  
   for (rend = rstart; *rend && *rend != ']'; rend++);  #else /* PEGASUS_HAS_ICU */
   if (*rend == ']') {  // if there is an end to this pattern  
     for (compchar = *rstart; rstart != rend; rstart++) {  
       if (_Equal(*rstart, c, nocase))  
         return ++rend;  
       if (*rstart == '-') {  
         rstart++;  
         if (c >= compchar && c <= *rstart)  
           return ++rend;  
       }  
     }  
   }  
   return (const MatchChar *)0;  
 }  
  
 static int      // ATTN: optimize this!
 _StringMatch(      return String::equalNoCase(s1, String(s2));
     const MatchChar *testString,  
     const MatchChar *pattern,  
     int nocase )                /* Ignore case if this is true */  
 {  
   const MatchChar *pat = pattern;  
   const MatchChar *str = testString;  
   unsigned int done = 0;  
   unsigned int res = 0;  // the result: 1 == match  
  
   while (!done) { // main loop walks through pattern and test string  #endif /* PEGASUS_HAS_ICU */
     //cerr << "Comparing <" << *pat << "> and <" << *str << ">" << endl;  
     if (!*pat) {                                         //end of pattern  
       done = 1;                                          // we're done  
       if (!*str)                                         //end of test, too?  
         res = 1;                                         // then we matched  
     } else {                                             //Not end of pattern  
       if (!*str) {                                       // but end of test  
         done = 1;                                        // We're done  
         if (*pat == '*')                                 // If pattern openends  
           res = 1;                                       //  then we matched  
       } else {                                           //Not end of test  
         if (*pat == '*') {                               //Ambiguuity found  
           if (!*++pat) {                                 //and it ends pattern  
             done = 1;                                    //  then we're done  
             res = 1;                                     //  and match  
           } else {                                       //if it doesn't end  
             while (!done) {                              //  until we're done  
               if (_StringMatch(str, pat, nocase)) {      //  we recurse  
                 done = 1;                                //if it recurses true  
                 res = 1;                                 //  we done and match  
               } else {                                   //it recurses false  
                 if (!*str)                               // see if test is done  
                   done = 1;                              //  yes: we done  
                 else                                     // not done:  
                   str++;                                 //   keep testing  
               } // end test on recursive call  
             } // end looping on recursive calls  
           } // end logic when pattern is ambiguous  
         } else {                                         //pattern not ambiguus  
           if (*pat == '?') {                             //pattern is 'any'  
             pat++, str++;                                //  so move along  
           } else if (*pat == '[') {                      //see if it's a range  
             pat = _matchrange(pat, *str, nocase);         // and is a match  
             if (!pat) {                                  //It is not a match  
               done = 1;                                  //  we're done  
               res = 0;                                   //  no match  
             } else {                                     //Range matches  
               str++, pat++;                              //  keep going  
             }  
           } else {               // only case left is individual characters  
             if (!_Equal(*pat++, *str++, nocase))         // if they don't match  
               done = 1;                                  //   bail.  
           }           }
         }  // end ("pattern is not ambiguous (*)" logic  
       } // end logic when pattern and string still have data  
     } // end logic when pattern still has data  
   } // end main loop  
   return res;  
 }  
   
  
 Boolean String::match(const String& str, const String& pattern)  Boolean String::equal(const String& s1, const String& s2)
 { {
     return _StringMatch(      return s1._rep->size == s2._rep->size && memcmp(s1._rep->data,
         (Uint16*)str.getData(), (Uint16*)pattern.getData(), 0) != 0;          s2._rep->data, s1._rep->size * sizeof(Uint16)) == 0;
 } }
  
 Boolean String::matchNoCase(const String& str, const String& pattern)  Boolean String::equal(const String& s1, const char* s2)
 { {
     return _StringMatch(  #ifdef PEGASUS_STRING_NO_UTF8
         (Uint16*)str.getData(), (Uint16*)pattern.getData(), 1) != 0;  
 }  
  
       _check_null_pointer(s2);
  
 ///////////////////////////////////////////////////////////////////////////////      const Uint16* p = (Uint16*)s1._rep->data;
 //      const char* q = s2;
 // String-related functions  
 //  
 ///////////////////////////////////////////////////////////////////////////////  
  
 Boolean operator==(const String& str1, const String& str2)      while (*p && *q)
 { {
     return String::equal(str1, str2);          if (*p++ != Uint16(*q++))
               return false;
 } }
  
 Boolean operator==(const String& str1, const char* str2)      return !(*p || *q);
 {  
     return String::equal(str1, str2);  #else /* PEGASUS_STRING_NO_UTF8 */
   
       return String::equal(s1, String(s2));
   
   #endif /* PEGASUS_STRING_NO_UTF8 */
 } }
  
 Boolean operator==(const char* str1, const String& str2)  PEGASUS_STD(ostream)& operator<<(PEGASUS_STD(ostream)& os, const String& str)
 { {
     return String::equal(str1, str2);  #if defined(PEGASUS_OS_OS400)
 }  
  
 Boolean operator!=(const String& str1, const String& str2)      CString cstr = str.getCString();
       const char* utf8str = cstr;
       os << utf8str;
       return os;
   #else
   
   #if defined(PEGASUS_HAS_ICU)
   
       if (InitializeICU::initICUSuccessful())
 { {
     return !String::equal(str1, str2);          char *buf = NULL;
           const int size = str.size() * 6;
           UnicodeString UniStr(
               (const UChar *)str.getChar16Data(), (int32_t)str.size());
           Uint32 bufsize = UniStr.extract(0,size,buf);
           buf = new char[bufsize+1];
           UniStr.extract(0,bufsize,buf);
           os << buf;
           os.flush();
           delete [] buf;
           return os;
 } }
  
 PEGASUS_STD(ostream)& operator<<(PEGASUS_STD(ostream)& os, const String& str)  #endif  // PEGASUS_HAS_ICU
 {  
     for (Uint32 i = 0, n = str.size(); i < n; i++)     for (Uint32 i = 0, n = str.size(); i < n; i++)
     {     {
         Uint16 code = str[i];         Uint16 code = str[i];
  
         if (code > 0 && code <= PEGASUS_MAX_PRINTABLE_CHAR)          if (code > 0 && !(code & 0xFF00))
         {  
             os << char(code);             os << char(code);
         }  
         else         else
         {         {
             // Print in hex format:             // Print in hex format:
Line 685 
Line 1252 
     }     }
  
     return os;     return os;
   #endif // PEGASUS_OS_OS400
 } }
  
 String operator+(const String& str1, const String& str2)  void String_append_char_aux(StringRep*& _rep)
 { {
     return String(str1).append(str2);      StringRep* tmp;
 }  
  
 Boolean operator<(const String& str1, const String& str2)      if (_rep->cap)
 { {
     return String::compare(str1, str2) < 0;          tmp = StringRep::alloc(2 * _rep->cap);
           tmp->size = _rep->size;
           _copy(tmp->data, _rep->data, _rep->size);
 } }
       else
 Boolean operator<=(const String& str1, const String& str2)  
 { {
     return String::compare(str1, str2) <= 0;          tmp = StringRep::alloc(8);
           tmp->size = 0;
 } }
  
 Boolean operator>(const String& str1, const String& str2)      StringRep::unref(_rep);
 {      _rep = tmp;
     return String::compare(str1, str2) > 0;  
 } }
  
 Boolean operator>=(const String& str1, const String& str2)  PEGASUS_NAMESPACE_END
 {  
     return String::compare(str1, str2) >= 0;  
 }  
  
 int CompareNoCase(const char* s1, const char* s2)  /*
 {  ================================================================================
     while (*s1 && *s2)  
   String optimizations:
   
       1.  Added mechanism allowing certain functions to be inlined only when
           used by internal Pegasus modules. External modules (i.e., providers)
           link to a non-inline version, which allows for binary compatibility.
   
       2.  Implemented copy-on-write with atomic increment/decrement. This
           yieled a 10% improvement for the 'gc' benchmark and a 11% improvment
           for the 'ni1000' benchmark.
   
       3.  Employed loop unrolling in several places. For example, see:
   
               static Uint16* _find(const Uint16* s, size_t n, Uint16 c);
   
       4.  Used the "empty-rep" optimization (described in whitepaper from the
           GCC Developers Summit). This reduced default construction to a simple
           pointer assignment.
   
               inline String::String() : _rep(&_empty_rep) { }
   
       5.  Implemented Uint16 versions of toupper() and tolower() using tables.
           For example:
   
               static const char _upper[] =
     {     {
         int r = tolower(*s1++) - tolower(*s2++);                  0,1,2,...255
               };
  
         if (r)              inline Uint16 _to_upper(Uint16 x)
             return r;              {
                   return (x & 0xFF00) ? x : _upper[x];
     }     }
  
     if (*s2)          This outperforms the system implementation by avoiding an anding
         return -1;          operation.
     else if (*s1)  
         return 1;  
  
     return 0;      6.  Implemented char* version of the following member functions to
           eliminate unecessary creation of anonymous string objects
           (temporaries).
   
               String(const String& s1, const char* s2);
               String(const char* s1, const String& s2);
               String& String::operator=(const char* str);
               Uint32 String::find(const char* s) const;
               bool String::equal(const String& s1, const char* s2);
               static int String::compare(const String& s1, const char* s2);
               String& String::append(const char* str);
               String& String::append(const char* str, Uint32 size);
               static bool String::equalNoCase(const String& s1, const char* s2);
               String& operator=(const char* str)
               String& String::assign(const char* str)
               String& String::append(const char* str)
               Boolean operator==(const String& s1, const char* s2)
               Boolean operator==(const char* s1, const String& s2)
               Boolean operator!=(const String& s1, const char* s2)
               Boolean operator!=(const char* s1, const String& s2)
               Boolean operator<(const String& s1, const char* s2)
               Boolean operator<(const char* s1, const String& s2)
               Boolean operator>(const String& s1, const char* s2)
               Boolean operator>(const char* s1, const String& s2)
               Boolean operator<=(const String& s1, const char* s2)
               Boolean operator<=(const char* s1, const String& s2)
               Boolean operator>=(const String& s1, const char* s2)
               Boolean operator>=(const char* s1, const String& s2)
               String operator+(const String& s1, const char* s2)
               String operator+(const char* s1, const String& s2)
   
       7.  Optimized _roundUpToPow2(), used in rounding the capacity to the next
           power of two (algorithm from the book "Hacker's Delight").
   
               static Uint32 _roundUpToPow2(Uint32 x)
               {
                   if (x < 8)
                       return 8;
   
                   x--;
                   x |= (x >> 1);
                   x |= (x >> 2);
                   x |= (x >> 4);
                   x |= (x >> 8);
                   x |= (x >> 16);
                   x++;
   
                   return x;
 } }
  
 int EqualNoCase(const char* s1, const char* s2)      8.  Implemented "concatenating constructors" to eliminate temporaries
           created by operator+(). This scheme employs the "return-value
           optimization" described by Stan Lippman.
   
               inline String operator+(const String& s1, const String& s2)
 { {
     return CompareNoCase(s1, s2) == 0;                  return String(s1, s2, 0);
 } }
  
 PEGASUS_NAMESPACE_END      9.  Experimented to find the optimial initial size for a short string.
           Eight seems to offer the best tradeoff between space and time.
   
       10. Inlined all members of the Char16 class.
   
       11. Used Uint16 internally in the String class. This showed no improvememnt
           since Char16 was already fully inlined and was essentially reduced to
           Uint16 in any case.
   
       12. Implemented conditional logic (#if) allowing error checking logic to
           be excluded to better performance. Examples include bounds checking
           and null-pointer checking.
   
       13. Used memcpy() and memcmp() where possible. These are implemented using
           the rep family of intructions under Intel and are much faster.
   
       14. Used loop unrolling, jump-tables, and short-circuiting to reduce UTF8
           copy routine overhead.
   
       15. Added ASCII7 form of the constructor and assign().
   
               String s("hello world", String::ASCII7);
   
               s.assignASCII7("hello world");
   
           This avoids slower UTF8 processing when not needed.
   
   ================================================================================
   
   TO-DO:
   
       (+) [DONE] Use PEGASUS_USE_EXPERIMENTAL_INTERFACES
   
       (+) [DONE] Submit BUG-2754 (Windows buffer limit).
   
       (+) [DONE] Eliminate char versions of find() and append().
   
       (+) [DONE] Remove PEGASUS_MAX_PRINTABLE_CHARACTER from Config.h
   
       (+) [DONE] Change _next_pow_2() to _roundUpToPow2().
   
       (+) [DONE] Change '99' to '2' in StringRep constructor (comment as well).
   
       (+) [DONE] Comment StringRep allocation layout.
   
       (+) [DONE] Conceal private inline functions.
   
       (+) [DONE] Shorten inclusion of StringInline.h in String.h.
   
       (+) [DONE] Change USE_INTERNAL_INLINE TO DISABLE_INTERNAL_INLINE or get
           rid of altogether.
   
       -----------
   
       (+) Check for overlow condition in StringRep::alloc().
   
       (+) useCamelNotationOnAllFunctionNames.
   
       (+) Fix throw-related memory leak.
   
       (+) DOC++ String.h
   
       (+) Look at PEP223 for coding security guidelines.
   
       (+) Rework AtomicInt (put into AtomicInt.h).
   
       (+) Implement Atomic operations for HP.
   
       (+) Remove tabs.
   
   ================================================================================
   */


Legend:
Removed from v.1.53  
changed lines
  Added in v.1.111.6.5

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2