]> git.stg.codes - stg.git/commitdiff
Видалено не використовуваний заголовочний файл stgstring.h
authorMaxim Mamontov <faust@gts.dp.ua>
Wed, 5 Jan 2011 10:00:20 +0000 (12:00 +0200)
committerMaxim Mamontov <faust@gts.dp.ua>
Wed, 5 Jan 2011 10:00:20 +0000 (12:00 +0200)
include/stdstring.h [deleted file]

diff --git a/include/stdstring.h b/include/stdstring.h
deleted file mode 100644 (file)
index dde89e9..0000000
+++ /dev/null
@@ -1,3737 +0,0 @@
-// =============================================================================\r
-//  FILE:  StdString.h\r
-//  AUTHOR:    Joe O'Leary (with outside help noted in comments)\r
-//  REMARKS:\r
-//             This header file declares the CStdStr template.  This template derives\r
-//             the Standard C++ Library basic_string<> template and add to it the\r
-//             the following conveniences:\r
-//                     - The full MFC CString set of functions (including implicit cast)\r
-//                     - writing to/reading from COM IStream interfaces\r
-//                     - Functional objects for use in STL algorithms\r
-//\r
-//             From this template, we intstantiate two classes:  CStdStringA and\r
-//             CStdStringW.  The name "CStdString" is just a #define of one of these,\r
-//             based upone the _UNICODE macro setting\r
-//\r
-//             This header also declares our own version of the MFC/ATL UNICODE-MBCS\r
-//             conversion macros.  Our version looks exactly like the Microsoft's to\r
-//             facilitate portability.\r
-//\r
-//     NOTE:\r
-//             If you you use this in an MFC or ATL build, you should include either\r
-//             afx.h or atlbase.h first, as appropriate.\r
-//\r
-//     PEOPLE WHO HAVE CONTRIBUTED TO THIS CLASS:\r
-//\r
-//             Several people have helped me iron out problems and othewise improve\r
-//             this class.  OK, this is a long list but in my own defense, this code\r
-//             has undergone two major rewrites.  Many of the improvements became\r
-//             necessary after I rewrote the code as a template.  Others helped me\r
-//             improve the CString facade.\r
-//\r
-//             Anyway, these people are (in chronological order):\r
-//\r
-//                     - Pete the Plumber (???)\r
-//                     - Julian Selman\r
-//                     - Chris (of Melbsys)\r
-//                     - Dave Plummer\r
-//                     - John C Sipos\r
-//                     - Chris Sells\r
-//                     - Nigel Nunn\r
-//                     - Fan Xia\r
-//                     - Matthew Williams\r
-//                     - Carl Engman\r
-//                     - Mark Zeren\r
-//                     - Craig Watson\r
-//                     - Rich Zuris\r
-//                     - Karim Ratib\r
-//                     - Chris Conti\r
-//                     - Baptiste Lepilleur\r
-//                     - Greg Pickles\r
-//                     - Jim Cline\r
-//                     - Jeff Kohn\r
-//                     - Todd Heckel\r
-//                     - Ullrich Pollähne\r
-//                     - Joe Vitaterna\r
-//                     - Joe Woodbury\r
-//                     - Aaron (no last name)\r
-//                     - Joldakowski (???)\r
-//                     - Scott Hathaway\r
-//                     - Eric Nitzche\r
-//                     - Pablo Presedo\r
-//                     - Farrokh Nejadlotfi\r
-//                     - Jason Mills\r
-//                     - Igor Kholodov\r
-//                     - Mike Crusader\r
-//                     - John James\r
-//                     - Wang Haifeng\r
-//                     - Tim Dowty\r
-//          - Arnt Witteveen\r
-//          - Glen Maynard\r
-//          - Paul DeMarco\r
-//          - Bagira (full name?)\r
-//          - Ronny Schulz\r
-//          - Jakko Van Hunen\r
-//                     - Charles G\r
-//\r
-//     REVISION HISTORY\r
-//    2003-JUL-10 - Thanks to Charles G for making me realize my 'FmtArg' fixes\r
-//                  had inadvertently broken the DLL-export code (which is\r
-//                  normally commented out.  I had to move it up higher.  Also\r
-//                                     this helped me catch a bug in ssicoll that would prevent\r
-//                  compilation, otherwise.\r
-//\r
-//    2003-MAR-14 - Thanks to Jakko Van Hunen for pointing out a copy-and-paste\r
-//                  bug in one of the overloads of FmtArg.\r
-//\r
-//    2003-MAR-10 - Thanks to Ronny Schulz for (twice!) sending me some changes\r
-//                  to help CStdString build on SGI and for pointing out an\r
-//                  error in placement of my preprocessor macros for ssfmtmsg.\r
-//\r
-//    2002-NOV-26 - Thanks to Bagira for pointing out that my implementation of\r
-//                  SpanExcluding was not properly handling the case in which\r
-//                  the string did NOT contain any of the given characters\r
-//\r
-//    2002-OCT-21 - Many thanks to Paul DeMarco who was invaluable in helping me\r
-//                  get this code working with Borland's free compiler as well\r
-//                  as the Dev-C++ compiler (available free at SourceForge).\r
-//\r
-//    2002-SEP-13 - Thanks to Glen Maynard who helped me get rid of some loud\r
-//                  but harmless warnings that were showing up on g++.  Glen\r
-//                  also pointed out that some pre-declarations of FmtArg<>\r
-//                  specializations were unnecessary (and no good on G++)\r
-//\r
-//    2002-JUN-26 - Thanks to Arnt Witteveen for pointing out that I was using\r
-//                  static_cast<> in a place in which I should have been using\r
-//                  reinterpret_cast<> (the ctor for unsigned char strings).\r
-//                  That's what happens when I don't unit-test properly!\r
-//                  Arnt also noticed that CString was silently correcting the\r
-//                  'nCount' argument to Left() and Right() where CStdString was\r
-//                  not (and crashing if it was bad).  That is also now fixed!\r
-//\r
-//       2002-FEB-25 - Thanks to Tim Dowty for pointing out (and giving me the fix\r
-//                                     for) a conversion problem with non-ASCII MBCS characters.\r
-//                                     CStdString is now used in my favorite commercial MP3 player!\r
-//\r
-//       2001-DEC-06 - Thanks to Wang Haifeng for spotting a problem in one of the\r
-//                                     assignment operators (for _bstr_t) that would cause compiler\r
-//                                     errors when refcounting protection was turned off.\r
-//\r
-//       2001-NOV-27 - Remove calls to operator!= which involve reverse_iterators\r
-//                                     due to a conflict with the rel_ops operator!=.  Thanks to\r
-//                                     John James for pointing this out.\r
-//\r
-//    2001-OCT-29 - Added a minor range checking fix for the Mid function to\r
-//                                     make it as forgiving as CString's version is.  Thanks to\r
-//                                     Igor Kholodov for noticing this.  \r
-//                               - Added a specialization of std::swap for CStdString.  Thanks\r
-//                                     to Mike Crusader for suggesting this!  It's commented out\r
-//                                     because you're not supposed to inject your own code into the\r
-//                                     'std' namespace.  But if you don't care about that, it's\r
-//                                     there if you want it\r
-//                               - Thanks to Jason Mills for catching a case where CString was\r
-//                                     more forgiving in the Delete() function than I was.\r
-//\r
-//       2001-JUN-06 - I was violating the Standard name lookup rules stated\r
-//                                     in [14.6.2(3)].  None of the compilers I've tried so\r
-//                                     far apparently caught this but HP-UX aCC 3.30 did.  The\r
-//                                     fix was to add 'this->' prefixes in many places.\r
-//                                     Thanks to Farrokh Nejadlotfi for this!\r
-//\r
-//       2001-APR-27 - StreamLoad was calculating the number of BYTES in one\r
-//                                     case, not characters.  Thanks to Pablo Presedo for this.\r
-//\r
-//    2001-FEB-23 - Replace() had a bug which caused infinite loops if the\r
-//                                     source string was empty.  Fixed thanks to Eric Nitzsche.\r
-//\r
-//    2001-FEB-23 - Scott Hathaway was a huge help in providing me with the\r
-//                                     ability to build CStdString on Sun Unix systems.  He\r
-//                                     sent me detailed build reports about what works and what\r
-//                                     does not.  If CStdString compiles on your Unix box, you\r
-//                                     can thank Scott for it.\r
-//\r
-//       2000-DEC-29 - Joldakowski noticed one overload of Insert failed to do a\r
-//                                     range check as CString's does.  Now fixed -- thanks!\r
-//\r
-//       2000-NOV-07 - Aaron pointed out that I was calling static member\r
-//                                     functions of char_traits via a temporary.  This was not\r
-//                                     technically wrong, but it was unnecessary and caused\r
-//                                     problems for poor old buggy VC5.  Thanks Aaron!\r
-//\r
-//       2000-JUL-11 - Joe Woodbury noted that the CString::Find docs don't match\r
-//                                     what the CString::Find code really ends up doing.   I was\r
-//                                     trying to match the docs.  Now I match the CString code\r
-//                               - Joe also caught me truncating strings for GetBuffer() calls\r
-//                                     when the supplied length was less than the current length.\r
-//\r
-//       2000-MAY-25 - Better support for STLPORT's Standard library distribution\r
-//                               - Got rid of the NSP macro - it interfered with Koenig lookup\r
-//                               - Thanks to Joe Woodbury for catching a TrimLeft() bug that\r
-//                                     I introduced in January.  Empty strings were not getting\r
-//                                     trimmed\r
-//\r
-//       2000-APR-17 - Thanks to Joe Vitaterna for pointing out that ReverseFind\r
-//                                     is supposed to be a const function.\r
-//\r
-//       2000-MAR-07 - Thanks to Ullrich Pollähne for catching a range bug in one\r
-//                                     of the overloads of assign.\r
-//\r
-//    2000-FEB-01 - You can now use CStdString on the Mac with CodeWarrior!\r
-//                                     Thanks to Todd Heckel for helping out with this.\r
-//\r
-//       2000-JAN-23 - Thanks to Jim Cline for pointing out how I could make the\r
-//                                     Trim() function more efficient.\r
-//                               - Thanks to Jeff Kohn for prompting me to find and fix a typo\r
-//                                     in one of the addition operators that takes _bstr_t.\r
-//                               - Got rid of the .CPP file -  you only need StdString.h now!\r
-//\r
-//       1999-DEC-22 - Thanks to Greg Pickles for helping me identify a problem\r
-//                                     with my implementation of CStdString::FormatV in which\r
-//                                     resulting string might not be properly NULL terminated.\r
-//\r
-//       1999-DEC-06 - Chris Conti pointed yet another basic_string<> assignment\r
-//                                     bug that MS has not fixed.  CStdString did nothing to fix\r
-//                                     it either but it does now!  The bug was: create a string\r
-//                                     longer than 31 characters, get a pointer to it (via c_str())\r
-//                                     and then assign that pointer to the original string object.\r
-//                                     The resulting string would be empty.  Not with CStdString!\r
-//\r
-//       1999-OCT-06 - BufferSet was erasing the string even when it was merely\r
-//                                     supposed to shrink it.  Fixed.  Thanks to Chris Conti.\r
-//                               - Some of the Q172398 fixes were not checking for assignment-\r
-//                                     to-self.  Fixed.  Thanks to Baptiste Lepilleur.\r
-//\r
-//       1999-AUG-20 - Improved Load() function to be more efficient by using \r
-//                                     SizeOfResource().  Thanks to Rich Zuris for this.\r
-//                               - Corrected resource ID constructor, again thanks to Rich.\r
-//                               - Fixed a bug that occurred with UNICODE characters above\r
-//                                     the first 255 ANSI ones.  Thanks to Craig Watson. \r
-//                               - Added missing overloads of TrimLeft() and TrimRight().\r
-//                                     Thanks to Karim Ratib for pointing them out\r
-//\r
-//       1999-JUL-21 - Made all calls to GetBuf() with no args check length first.\r
-//\r
-//       1999-JUL-10 - Improved MFC/ATL independence of conversion macros\r
-//                               - Added SS_NO_REFCOUNT macro to allow you to disable any\r
-//                                     reference-counting your basic_string<> impl. may do.\r
-//                               - Improved ReleaseBuffer() to be as forgiving as CString.\r
-//                                     Thanks for Fan Xia for helping me find this and to\r
-//                                     Matthew Williams for pointing it out directly.\r
-//\r
-//       1999-JUL-06 - Thanks to Nigel Nunn for catching a very sneaky bug in\r
-//                                     ToLower/ToUpper.  They should call GetBuf() instead of\r
-//                                     data() in order to ensure the changed string buffer is not\r
-//                                     reference-counted (in those implementations that refcount).\r
-//\r
-//       1999-JUL-01 - Added a true CString facade.  Now you can use CStdString as\r
-//                                     a drop-in replacement for CString.  If you find this useful,\r
-//                                     you can thank Chris Sells for finally convincing me to give\r
-//                                     in and implement it.\r
-//                               - Changed operators << and >> (for MFC CArchive) to serialize\r
-//                                     EXACTLY as CString's do.  So now you can send a CString out\r
-//                                     to a CArchive and later read it in as a CStdString.   I have\r
-//                                     no idea why you would want to do this but you can. \r
-//\r
-//       1999-JUN-21 - Changed the CStdString class into the CStdStr template.\r
-//                               - Fixed FormatV() to correctly decrement the loop counter.\r
-//                                     This was harmless bug but a bug nevertheless.  Thanks to\r
-//                                     Chris (of Melbsys) for pointing it out\r
-//                               - Changed Format() to try a normal stack-based array before\r
-//                                     using to _alloca().\r
-//                               - Updated the text conversion macros to properly use code\r
-//                                     pages and to fit in better in MFC/ATL builds.  In other\r
-//                                     words, I copied Microsoft's conversion stuff again. \r
-//                               - Added equivalents of CString::GetBuffer, GetBufferSetLength\r
-//                               - new sscpy() replacement of CStdString::CopyString()\r
-//                               - a Trim() function that combines TrimRight() and TrimLeft().\r
-//\r
-//       1999-MAR-13 - Corrected the "NotSpace" functional object to use _istpace()\r
-//                                     instead of _isspace()   Thanks to Dave Plummer for this.\r
-//\r
-//       1999-FEB-26 - Removed errant line (left over from testing) that #defined\r
-//                                     _MFC_VER.  Thanks to John C Sipos for noticing this.\r
-//\r
-//       1999-FEB-03 - Fixed a bug in a rarely-used overload of operator+() that\r
-//                                     caused infinite recursion and stack overflow\r
-//                               - Added member functions to simplify the process of\r
-//                                     persisting CStdStrings to/from DCOM IStream interfaces \r
-//                               - Added functional objects (e.g. StdStringLessNoCase) that\r
-//                                     allow CStdStrings to be used as keys STL map objects with\r
-//                                     case-insensitive comparison \r
-//                               - Added array indexing operators (i.e. operator[]).  I\r
-//                                     originally assumed that these were unnecessary and would be\r
-//                                     inherited from basic_string.  However, without them, Visual\r
-//                                     C++ complains about ambiguous overloads when you try to use\r
-//                                     them.  Thanks to Julian Selman to pointing this out. \r
-//\r
-//       1998-FEB-?? - Added overloads of assign() function to completely account\r
-//                                     for Q172398 bug.  Thanks to "Pete the Plumber" for this\r
-//\r
-//       1998-FEB-?? - Initial submission\r
-//\r
-// COPYRIGHT:\r
-//             2002 Joseph M. O'Leary.  This code is 100% free.  Use it anywhere you\r
-//      want.  Rewrite it, restructure it, whatever.  If you can write software\r
-//      that makes money off of it, good for you.  I kinda like capitalism. \r
-//      Please don't blame me if it causes your $30 billion dollar satellite\r
-//      explode in orbit.  If you redistribute it in any form, I'd appreciate it\r
-//      if you would leave this notice here.\r
-//\r
-//             If you find any bugs, please let me know:\r
-//\r
-//                             jmoleary@earthlink.net\r
-//                             http://www.joeo.net\r
-//\r
-//      The latest version of this code should always be available at the\r
-//      following link:\r
-//\r
-//              http://www.joeo.net/code/StdString.zip\r
-// =============================================================================\r
-\r
-// Avoid multiple inclusion the VC++ way,\r
-// Turn off browser references\r
-// Turn off unavoidable compiler warnings\r
-\r
-#if defined(_MSC_VER) && (_MSC_VER > 1100)\r
-       #pragma once\r
-       #pragma component(browser, off, references, "CStdString")\r
-       #pragma warning (disable : 4290) // C++ Exception Specification ignored\r
-       #pragma warning (disable : 4127) // Conditional expression is constant\r
-       #pragma warning (disable : 4097) // typedef name used as synonym for class name\r
-#endif\r
-\r
-// Borland warnings to turn off\r
-#ifdef __BORLANDC__\r
-    #pragma option push -w-inl\r
-//     #pragma warn -inl   // Turn off inline function warnings\r
-#endif\r
-\r
-#ifndef STDSTRING_H\r
-#define STDSTRING_H\r
-\r
-// MACRO: SS_UNSIGNED\r
-// ------------------\r
-//      This macro causes the addition of a constructor and assignment operator\r
-//      which take unsigned characters.  CString has such functions and in order\r
-//      to provide maximum CString-compatability, this code needs them as well.\r
-//      In practice you will likely never need these functions...\r
-\r
-//#define SS_UNSIGNED\r
-\r
-#ifdef SS_ALLOW_UNSIGNED_CHARS\r
-       #define SS_UNSIGNED\r
-#endif\r
-\r
-// MACRO: SS_SAFE_FORMAT\r
-// ---------------------\r
-//      This macro provides limited compatability with a questionable CString\r
-//      "feature".  You can define it in order to avoid a common problem that\r
-//      people encounter when switching from CString to CStdString.\r
-//\r
-//      To illustrate the problem -- With CString, you can do this:\r
-//\r
-//          CString sName("Joe");\r
-//          CString sTmp;\r
-//          sTmp.Format("My name is %s", sName);                    // WORKS!\r
-//\r
-//      However if you were to try this with CStdString, your program would\r
-//      crash.\r
-//\r
-//          CStdString sName("Joe");\r
-//          CStdString sTmp;\r
-//          sTmp.Format("My name is %s", sName);                    // CRASHES!\r
-//\r
-//      You must explicitly call c_str() or cast the object to the proper type\r
-//\r
-//          sTmp.Format("My name is %s", sName.c_str());            // WORKS!\r
-//          sTmp.Format("My name is %s", static_cast<PCSTR>(sName));// WORKS!\r
-//          sTmp.Format("My name is %s", (PCSTR)sName);// WORKS!\r
-//\r
-//      This is because it is illegal to pass anything but a POD type as a\r
-//      variadic argument to a variadic function (i.e. as one of the "..."\r
-//      arguments).  The type const char* is a POD type.  The type CStdString\r
-//      is not.  Of course, neither is the type CString, but CString lets you do\r
-//      it anyway due to the way they laid out the class in binary.  I have no\r
-//      control over this in CStdString since I derive from whatever\r
-//      implementation of basic_string is available.\r
-//\r
-//      However if you have legacy code (which does this) that you want to take\r
-//      out of the MFC world and you don't want to rewrite all your calls to\r
-//      Format(), then you can define this flag and it will no longer crash.\r
-//\r
-//      Note however that this ONLY works for Format(), not sprintf, fprintf, \r
-//      etc.  If you pass a CStdString object to one of those functions, your\r
-//      program will crash.  Not much I can do to get around this, short of\r
-//      writing substitutes for those functions as well.\r
-\r
-#define SS_SAFE_FORMAT  // use new template style Format() function\r
-\r
-\r
-// MACRO: SS_NO_IMPLICIT_CAST\r
-// --------------------------\r
-//      Some people don't like the implicit cast to const char* (or rather to\r
-//      const CT*) that CStdString (and MFC's CString) provide.  That was the\r
-//      whole reason I created this class in the first place, but hey, whatever\r
-//      bakes your cake.  Just #define this macro to get rid of the the implicit\r
-//      cast.\r
-\r
-//#define SS_NO_IMPLICIT_CAST // gets rid of operator const CT*()\r
-\r
-\r
-// MACRO: SS_NO_REFCOUNT\r
-// ---------------------\r
-//             turns off reference counting at the assignment level.  Only needed\r
-//             for the version of basic_string<> that comes with Visual C++ versions\r
-//             6.0 or earlier, and only then in some heavily multithreaded scenarios.\r
-//             Uncomment it if you feel you need it.\r
-\r
-//#define SS_NO_REFCOUNT\r
-\r
-// MACRO: SS_WIN32\r
-// ---------------\r
-//      When this flag is set, we are building code for the Win32 platform and\r
-//      may use Win32 specific functions (such as LoadString).  This gives us\r
-//      a couple of nice extras for the code.\r
-//\r
-//      Obviously, Microsoft's is not the only compiler available for Win32 out\r
-//      there.  So I can't just check to see if _MSC_VER is defined to detect\r
-//      if I'm building on Win32.  So for now, if you use MS Visual C++ or\r
-//      Borland's compiler, I turn this on.  Otherwise you may turn it on\r
-//      yourself, if you prefer\r
-#if defined(_MSC_VER) || defined(__BORLANDC__) || defined(_WIN32)\r
-    #define SS_WIN32\r
-#endif\r
-\r
-// MACRO: SS_ANSI\r
-// --------------\r
-//      When this macro is defined, the code attempts only to use ANSI/ISO\r
-//      standard library functions to do it's work.  It will NOT attempt to use\r
-//      any Win32 of Visual C++ specific functions -- even if they are\r
-//      available.  You may define this flag yourself to prevent any Win32\r
-//      of VC++ specific functions from being called.\r
-\r
-// If we're not on Win32, we MUST use an ANSI build\r
-#ifndef SS_WIN32\r
-    #if !defined(SS_NO_ANSI)\r
-        #define SS_ANSI\r
-    #endif\r
-#endif\r
-\r
-// MACRO: SS_ALLOCA\r
-// ----------------\r
-//      Some implementations of the Standard C Library have a non-standard\r
-//      function known as alloca().  This functions allows one to allocate a\r
-//      variable amount of memory on the stack.  It comes in very useful for\r
-//      the ASCII/MBCS conversion macros.\r
-//\r
-//      Here we attempt to determine automatically if alloca() is available on\r
-//      this platform.  If so we define SS_ALLOCA to be the name of the alloca\r
-//      function.  If SS_ALLOCA is undefined later on, then the conversion\r
-//      macros will not be compiled.\r
-//\r
-//      You may prevent SS_ALLOCA\r
-\r
-\r
-\r
-// Avoid legacy code screw up: if _UNICODE is defined, UNICODE must be as well\r
-\r
-#if defined (_UNICODE) && !defined (UNICODE)\r
-       #define UNICODE\r
-#endif\r
-#if defined (UNICODE) && !defined (_UNICODE)\r
-       #define _UNICODE\r
-#endif\r
-\r
-// -----------------------------------------------------------------------------\r
-// MIN and MAX.  The Standard C++ template versions go by so many names (at\r
-// at least in the MS implementation) that you never know what's available\r
-// -----------------------------------------------------------------------------\r
-template<class Type>\r
-inline const Type& SSMIN(const Type& arg1, const Type& arg2)\r
-{\r
-       return arg2 < arg1 ? arg2 : arg1;\r
-}\r
-template<class Type>\r
-inline const Type& SSMAX(const Type& arg1, const Type& arg2)\r
-{\r
-       return arg2 > arg1 ? arg2 : arg1;\r
-}\r
-\r
-// If they have not #included W32Base.h (part of my W32 utility library) then\r
-// we need to define some stuff.  Otherwise, this is all defined there.\r
-\r
-#if !defined(W32BASE_H)\r
-\r
-       // If they want us to use only standard C++ stuff (no Win32 stuff)\r
-\r
-       #ifdef SS_ANSI\r
-\r
-               // On Win32 we have TCHAR.H so just include it.  This is NOT violating\r
-        // the spirit of SS_ANSI as we are not calling any Win32 functions here.\r
-        \r
-               #ifdef SS_WIN32\r
-\r
-                       #include <TCHAR.H>\r
-                       #include <WTYPES.H>\r
-                       #ifndef STRICT\r
-                               #define STRICT\r
-                       #endif\r
-\r
-        // ... but on non-Win32 platforms, we must #define the types we need.\r
-\r
-               #else\r
-\r
-                       typedef const char*             PCSTR;\r
-                       typedef char*                   PSTR;\r
-                       typedef const wchar_t*  PCWSTR;\r
-                       typedef wchar_t*                PWSTR;\r
-                       #ifdef UNICODE\r
-                               typedef wchar_t         TCHAR;\r
-                       #else\r
-                               typedef char            TCHAR;\r
-                       #endif\r
-                       typedef wchar_t                 OLECHAR;\r
-\r
-               #endif  // #ifndef _WIN32\r
-\r
-\r
-               // Make sure ASSERT and verify are defined using only ANSI stuff\r
-\r
-               #ifndef ASSERT\r
-                       #include <assert.h>\r
-                       #define ASSERT(f) assert((f))\r
-               #endif\r
-               #ifndef VERIFY\r
-                       #ifdef _DEBUG\r
-                               #define VERIFY(x) ASSERT((x))\r
-                       #else\r
-                               #define VERIFY(x) x\r
-                       #endif\r
-               #endif\r
-\r
-       #else // ...else SS_ANSI is NOT defined\r
-\r
-               #include <TCHAR.H>\r
-               #include <WTYPES.H>\r
-               #ifndef STRICT\r
-                       #define STRICT\r
-               #endif\r
-\r
-               // Make sure ASSERT and verify are defined\r
-\r
-               #ifndef ASSERT\r
-                       #include <crtdbg.h>\r
-                       #define ASSERT(f) _ASSERTE((f))\r
-               #endif\r
-               #ifndef VERIFY\r
-                       #ifdef _DEBUG\r
-                               #define VERIFY(x) ASSERT((x))\r
-                       #else\r
-                               #define VERIFY(x) x\r
-                       #endif\r
-               #endif\r
-\r
-       #endif // #ifdef SS_ANSI\r
-\r
-       #ifndef UNUSED\r
-               #define UNUSED(x) x\r
-       #endif\r
-\r
-#endif // #ifndef W32BASE_H\r
-\r
-// Standard headers needed\r
-\r
-#include <string>                      // basic_string\r
-#include <algorithm>           // for_each, etc.\r
-#include <functional>          // for StdStringLessNoCase, et al\r
-#include <locale>              // for various facets\r
-\r
-// If this is a recent enough version of VC include comdef.h, so we can write\r
-// member functions to deal with COM types & compiler support classes e.g. _bstr_t\r
-\r
-#if defined (_MSC_VER) && (_MSC_VER >= 1100)\r
-       #include <comdef.h>\r
-       #define SS_INC_COMDEF           // signal that we #included MS comdef.h file\r
-       #define STDSTRING_INC_COMDEF\r
-       #define SS_NOTHROW __declspec(nothrow)\r
-#else\r
-       #define SS_NOTHROW\r
-#endif\r
-\r
-#ifndef TRACE\r
-       #define TRACE_DEFINED_HERE\r
-       #define TRACE\r
-#endif\r
-\r
-// Microsoft defines PCSTR, PCWSTR, etc, but no PCTSTR.  I hate to use the\r
-// versions with the "L" in front of them because that's a leftover from Win 16\r
-// days, even though it evaluates to the same thing.  Therefore, Define a PCSTR\r
-// as an LPCTSTR.\r
-\r
-#if !defined(PCTSTR) && !defined(PCTSTR_DEFINED)\r
-       typedef const TCHAR*                    PCTSTR;\r
-       #define PCTSTR_DEFINED\r
-#endif\r
-\r
-#if !defined(PCOLESTR) && !defined(PCOLESTR_DEFINED)\r
-       typedef const OLECHAR*                  PCOLESTR;\r
-       #define PCOLESTR_DEFINED\r
-#endif\r
-\r
-#if !defined(POLESTR) && !defined(POLESTR_DEFINED)\r
-       typedef OLECHAR*                                POLESTR;\r
-       #define POLESTR_DEFINED\r
-#endif\r
-\r
-#if !defined(PCUSTR) && !defined(PCUSTR_DEFINED)\r
-       typedef const unsigned char*    PCUSTR;\r
-       typedef unsigned char*                  PUSTR;\r
-       #define PCUSTR_DEFINED\r
-#endif\r
-\r
-\r
-// SGI compiler 7.3 doesnt know these  types - oh and btw, remember to use\r
-// -LANG:std in the CXX Flags\r
-#if defined(__sgi)\r
-    typedef unsigned long           DWORD;\r
-    typedef void *                  LPCVOID;\r
-#endif\r
-\r
-\r
-// SS_USE_FACET macro and why we need it:\r
-//\r
-// Since I'm a good little Standard C++ programmer, I use locales.  Thus, I\r
-// need to make use of the use_facet<> template function here.   Unfortunately,\r
-// this need is complicated by the fact the MS' implementation of the Standard\r
-// C++ Library has a non-standard version of use_facet that takes more\r
-// arguments than the standard dictates.  Since I'm trying to write CStdString\r
-// to work with any version of the Standard library, this presents a problem.\r
-//\r
-// The upshot of this is that I can't do 'use_facet' directly.  The MS' docs\r
-// tell me that I have to use a macro, _USE() instead.  Since _USE obviously\r
-// won't be available in other implementations, this means that I have to write\r
-// my OWN macro -- SS_USE_FACET -- that evaluates either to _USE or to the\r
-// standard, use_facet.\r
-//\r
-// If you are having trouble with the SS_USE_FACET macro, in your implementation\r
-// of the Standard C++ Library, you can define your own version of SS_USE_FACET.\r
-#ifndef schMSG\r
-       #define schSTR(x)          #x\r
-       #define schSTR2(x)      schSTR(x)\r
-       #define schMSG(desc) message(__FILE__ "(" schSTR2(__LINE__) "):" #desc)\r
-#endif\r
-\r
-#ifndef SS_USE_FACET\r
-       // STLPort #defines a macro (__STL_NO_EXPLICIT_FUNCTION_TMPL_ARGS) for\r
-       // all MSVC builds, erroneously in my opinion.  It causes problems for\r
-       // my SS_ANSI builds.  In my code, I always comment out that line.  You'll\r
-       // find it in   \stlport\config\stl_msvc.h\r
-       #if defined(__SGI_STL_PORT) && (__SGI_STL_PORT >= 0x400 )\r
-               #if defined(__STL_NO_EXPLICIT_FUNCTION_TMPL_ARGS) && defined(_MSC_VER)\r
-                       #ifdef SS_ANSI\r
-                               #pragma schMSG(__STL_NO_EXPLICIT_FUNCTION_TMPL_ARGS defined!!)\r
-                       #endif\r
-               #endif\r
-               #define SS_USE_FACET(loc, fac) std::use_facet<fac >(loc)\r
-       #elif defined(_MSC_VER )\r
-       #define SS_USE_FACET(loc, fac) std::_USE(loc, fac)\r
-\r
-       // ...and\r
-       #elif defined(_RWSTD_NO_TEMPLATE_ON_RETURN_TYPE)\r
-        #define SS_USE_FACET(loc, fac) std::use_facet(loc, (fac*)0)\r
-       #else\r
-               #define SS_USE_FACET(loc, fac) std::use_facet<fac >(loc)\r
-       #endif\r
-#endif\r
-\r
-// =============================================================================\r
-// UNICODE/MBCS conversion macros.  Made to work just like the MFC/ATL ones.\r
-// =============================================================================\r
-\r
-#include <wchar.h>      // Added to Std Library with Amendment #1.\r
-\r
-// First define the conversion helper functions.  We define these regardless of\r
-// any preprocessor macro settings since their names won't collide. \r
-\r
-// Not sure if we need all these headers.   I believe ANSI says we do.\r
-\r
-#include <stdio.h>\r
-#include <stdarg.h>\r
-#include <wctype.h>\r
-#include <ctype.h>\r
-#include <stdlib.h>\r
-#ifndef va_start\r
-       #include <varargs.h>\r
-#endif\r
-\r
-// StdCodeCvt - made to look like Win32 functions WideCharToMultiByte\r
-//                             and MultiByteToWideChar but uses locales in SS_ANSI\r
-//                             builds\r
-//typedef int mbstate_t;\r
-#if defined (SS_ANSI) || !defined (SS_WIN32)\r
-\r
-    typedef std::codecvt<wchar_t, char, std::mbstate_t> SSCodeCvt;\r
-\r
-\r
-    inline PWSTR StdCodeCvt(PWSTR pW, PCSTR pA, int nChars,\r
-        const std::locale& loc=std::locale())\r
-    {\r
-        ASSERT(0 != pA);\r
-        ASSERT(0 != pW);\r
-        pW[0] = '\0';\r
-        PCSTR pBadA                            = 0;\r
-        PWSTR pBadW                            = 0;\r
-        SSCodeCvt::result res  = SSCodeCvt::ok;\r
-        const SSCodeCvt& conv  = SS_USE_FACET(loc, SSCodeCvt);\r
-        SSCodeCvt::state_type st= { 0 };\r
-        res                                            = conv.in(st,\r
-                                                                         pA, pA + nChars, pBadA,\r
-                                                                         pW, pW + nChars, pBadW);\r
-        ASSERT(SSCodeCvt::ok == res);\r
-        return pW;\r
-    }\r
-    inline PWSTR StdCodeCvt(PWSTR pW, PCUSTR pA, int nChars,\r
-        const std::locale& loc=std::locale())\r
-    {\r
-        return StdCodeCvt(pW, (PCSTR)pA, nChars, loc);\r
-    }\r
-\r
-    inline PSTR StdCodeCvt(PSTR pA, PCWSTR pW, int nChars,\r
-        const std::locale& loc=std::locale())\r
-    {\r
-        ASSERT(0 != pA);\r
-        ASSERT(0 != pW);\r
-        pA[0] = '\0';\r
-        PSTR pBadA                             = 0;\r
-        PCWSTR pBadW                   = 0;\r
-        SSCodeCvt::result res  = SSCodeCvt::ok;\r
-        const SSCodeCvt& conv  = SS_USE_FACET(loc, SSCodeCvt);\r
-        SSCodeCvt::state_type st= { 0 };\r
-        res                                            = conv.out(st,\r
-                                                                          pW, pW + nChars, pBadW,\r
-                                                                          pA, pA + nChars, pBadA);\r
-        ASSERT(SSCodeCvt::ok == res);\r
-        return pA;\r
-    }\r
-    inline PUSTR StdCodeCvt(PUSTR pA, PCWSTR pW, int nChars,\r
-        const std::locale& loc=std::locale())\r
-    {\r
-        return (PUSTR)StdCodeCvt((PSTR)pA, pW, nChars, loc);\r
-    }\r
-\r
-#else   // ...or are we doing things assuming win32 and Visual C++?\r
-\r
-       #include <malloc.h>     // needed for _alloca\r
-\r
-       inline PWSTR StdCodeCvt(PWSTR pW, PCSTR pA, int nChars, UINT acp=CP_ACP)\r
-       {\r
-               ASSERT(0 != pA);\r
-               ASSERT(0 != pW);\r
-               pW[0] = '\0';\r
-               MultiByteToWideChar(acp, 0, pA, -1, pW, nChars);\r
-               return pW;\r
-       }\r
-       inline PWSTR StdCodeCvt(PWSTR pW, PCUSTR pA, int nChars, UINT acp=CP_ACP)\r
-       {\r
-               return StdCodeCvt(pW, (PCSTR)pA, nChars, acp);\r
-       }\r
-\r
-       inline PSTR StdCodeCvt(PSTR pA, PCWSTR pW, int nChars, UINT acp=CP_ACP)\r
-       {\r
-               ASSERT(0 != pA);\r
-               ASSERT(0 != pW);\r
-               pA[0] = '\0';\r
-               WideCharToMultiByte(acp, 0, pW, -1, pA, nChars, 0, 0);\r
-               return pA;\r
-       }\r
-       inline PUSTR StdCodeCvt(PUSTR pA, PCWSTR pW, int nChars, UINT acp=CP_ACP)\r
-       {\r
-               return (PUSTR)StdCodeCvt((PSTR)pA, pW, nChars, acp);\r
-       }\r
-\r
-#endif\r
-// Unicode/MBCS conversion macros are only available on implementations of\r
-// the "C" library that have the non-standard _alloca function.  As far as I\r
-// know that's only Microsoft's though I've hear that the function exits\r
-// elsewhere.  \r
-    \r
-#if defined(SS_ALLOCA) && !defined SS_NO_CONVERSION\r
-\r
-    #include <malloc.h>        // needed for _alloca\r
-\r
-\r
-    // Define our conversion macros to look exactly like Microsoft's to\r
-    // facilitate using this stuff both with and without MFC/ATL\r
-\r
-    #ifdef _CONVERSION_USES_THREAD_LOCALE\r
-           #ifndef _DEBUG\r
-                   #define SSCVT int _cvt; _cvt; UINT _acp=GetACP(); \\r
-                           _acp; PCWSTR _pw; _pw; PCSTR _pa; _pa\r
-           #else\r
-                   #define SSCVT int _cvt = 0; _cvt; UINT _acp=GetACP();\\r
-                            _acp; PCWSTR _pw=0; _pw; PCSTR _pa=0; _pa\r
-           #endif\r
-    #else\r
-           #ifndef _DEBUG\r
-                   #define SSCVT int _cvt; _cvt; UINT _acp=CP_ACP; _acp;\\r
-                            PCWSTR _pw; _pw; PCSTR _pa; _pa\r
-           #else\r
-                   #define SSCVT int _cvt = 0; _cvt; UINT _acp=CP_ACP; \\r
-                           _acp; PCWSTR _pw=0; _pw; PCSTR _pa=0; _pa\r
-           #endif\r
-    #endif\r
-\r
-    #ifdef _CONVERSION_USES_THREAD_LOCALE\r
-           #define SSA2W(pa) (\\r
-                   ((_pa = pa) == 0) ? 0 : (\\r
-                           _cvt = (sslen(_pa)+1),\\r
-                           StdCodeCvt((PWSTR) _alloca(_cvt*2), _pa, _cvt, _acp)))\r
-           #define SSW2A(pw) (\\r
-                   ((_pw = pw) == 0) ? 0 : (\\r
-                           _cvt = (sslen(_pw)+1)*2,\\r
-                           StdW2AHelper((LPSTR) _alloca(_cvt), _pw, _cvt, _acp)))\r
-    #else\r
-           #define SSA2W(pa) (\\r
-                   ((_pa = pa) == 0) ? 0 : (\\r
-                           _cvt = (sslen(_pa)+1),\\r
-                           StdCodeCvt((PWSTR) _alloca(_cvt*2), _pa, _cvt)))\r
-           #define SSW2A(pw) (\\r
-                   ((_pw = pw) == 0) ? 0 : (\\r
-                           _cvt = (sslen(_pw)+1)*2,\\r
-                           StdCodeCvt((LPSTR) _alloca(_cvt), _pw, _cvt)))\r
-    #endif\r
-\r
-    #define SSA2CW(pa) ((PCWSTR)SSA2W((pa)))\r
-    #define SSW2CA(pw) ((PCSTR)SSW2A((pw)))\r
-\r
-    #ifdef UNICODE\r
-           #define SST2A       SSW2A\r
-           #define SSA2T       SSA2W\r
-           #define SST2CA      SSW2CA\r
-           #define SSA2CT      SSA2CW\r
-           inline PWSTR        SST2W(PTSTR p)                  { return p; }\r
-           inline PTSTR        SSW2T(PWSTR p)                  { return p; }\r
-           inline PCWSTR       SST2CW(PCTSTR p)                { return p; }\r
-           inline PCTSTR       SSW2CT(PCWSTR p)                { return p; }\r
-    #else\r
-           #define SST2W       SSA2W\r
-           #define SSW2T       SSW2A\r
-           #define SST2CW      SSA2CW\r
-           #define SSW2CT      SSW2CA\r
-           inline PSTR         SST2A(PTSTR p)                  { return p; }\r
-           inline PTSTR        SSA2T(PSTR p)                   { return p; }\r
-           inline PCSTR        SST2CA(PCTSTR p)                { return p; }\r
-           inline PCTSTR       SSA2CT(PCSTR p)                 { return p; }\r
-    #endif // #ifdef UNICODE\r
-\r
-    #if defined(UNICODE)\r
-    // in these cases the default (TCHAR) is the same as OLECHAR\r
-           inline PCOLESTR     SST2COLE(PCTSTR p)              { return p; }\r
-           inline PCTSTR       SSOLE2CT(PCOLESTR p)    { return p; }\r
-           inline POLESTR      SST2OLE(PTSTR p)                { return p; }\r
-           inline PTSTR        SSOLE2T(POLESTR p)              { return p; }\r
-    #elif defined(OLE2ANSI)\r
-    // in these cases the default (TCHAR) is the same as OLECHAR\r
-           inline PCOLESTR     SST2COLE(PCTSTR p)              { return p; }\r
-           inline PCTSTR       SSOLE2CT(PCOLESTR p)    { return p; }\r
-           inline POLESTR      SST2OLE(PTSTR p)                { return p; }\r
-           inline PTSTR        SSOLE2T(POLESTR p)              { return p; }\r
-    #else\r
-           //CharNextW doesn't work on Win95 so we use this\r
-           #define SST2COLE(pa)        SSA2CW((pa))\r
-           #define SST2OLE(pa)         SSA2W((pa))\r
-           #define SSOLE2CT(po)        SSW2CA((po))\r
-           #define SSOLE2T(po)         SSW2A((po))\r
-    #endif\r
-\r
-    #ifdef OLE2ANSI\r
-           #define SSW2OLE             SSW2A\r
-           #define SSOLE2W             SSA2W\r
-           #define SSW2COLE    SSW2CA\r
-           #define SSOLE2CW    SSA2CW\r
-           inline POLESTR              SSA2OLE(PSTR p)         { return p; }\r
-           inline PSTR                 SSOLE2A(POLESTR p)      { return p; }\r
-           inline PCOLESTR             SSA2COLE(PCSTR p)       { return p; }\r
-           inline PCSTR                SSOLE2CA(PCOLESTR p){ return p; }\r
-    #else\r
-           #define SSA2OLE             SSA2W\r
-           #define SSOLE2A             SSW2A\r
-           #define SSA2COLE    SSA2CW\r
-           #define SSOLE2CA    SSW2CA\r
-           inline POLESTR              SSW2OLE(PWSTR p)        { return p; }\r
-           inline PWSTR                SSOLE2W(POLESTR p)      { return p; }\r
-           inline PCOLESTR             SSW2COLE(PCWSTR p)      { return p; }\r
-           inline PCWSTR               SSOLE2CW(PCOLESTR p){ return p; }\r
-    #endif\r
-\r
-    // Above we've defined macros that look like MS' but all have\r
-    // an 'SS' prefix.  Now we need the real macros.  We'll either\r
-    // get them from the macros above or from MFC/ATL. \r
-\r
-       #if defined (USES_CONVERSION)\r
-\r
-               #define _NO_STDCONVERSION       // just to be consistent\r
-\r
-       #else\r
-\r
-               #ifdef _MFC_VER\r
-\r
-                       #include <afxconv.h>\r
-                       #define _NO_STDCONVERSION // just to be consistent\r
-\r
-               #else\r
-\r
-                       #define USES_CONVERSION SSCVT\r
-                       #define A2CW                    SSA2CW\r
-                       #define W2CA                    SSW2CA\r
-                       #define T2A                             SST2A\r
-                       #define A2T                             SSA2T\r
-                       #define T2W                             SST2W\r
-                       #define W2T                             SSW2T\r
-                       #define T2CA                    SST2CA\r
-                       #define A2CT                    SSA2CT\r
-                       #define T2CW                    SST2CW\r
-                       #define W2CT                    SSW2CT\r
-                       #define ocslen                  sslen\r
-                       #define ocscpy                  sscpy\r
-                       #define T2COLE                  SST2COLE\r
-                       #define OLE2CT                  SSOLE2CT\r
-                       #define T2OLE                   SST2COLE\r
-                       #define OLE2T                   SSOLE2CT\r
-                       #define A2OLE                   SSA2OLE\r
-                       #define OLE2A                   SSOLE2A\r
-                       #define W2OLE                   SSW2OLE\r
-                       #define OLE2W                   SSOLE2W\r
-                       #define A2COLE                  SSA2COLE\r
-                       #define OLE2CA                  SSOLE2CA\r
-                       #define W2COLE                  SSW2COLE\r
-                       #define OLE2CW                  SSOLE2CW\r
-       \r
-               #endif // #ifdef _MFC_VER\r
-       #endif // #ifndef USES_CONVERSION\r
-#endif // #ifndef SS_NO_CONVERSION\r
-\r
-// Define ostring - generic name for std::basic_string<OLECHAR>\r
-\r
-#if !defined(ostring) && !defined(OSTRING_DEFINED)\r
-       typedef std::basic_string<OLECHAR> ostring;\r
-       #define OSTRING_DEFINED\r
-#endif\r
-\r
-// StdCodeCvt when there's no conversion to be done\r
-inline PSTR StdCodeCvt(PSTR pDst, PCSTR pSrc, int nChars)\r
-{\r
-       if ( nChars > 0 )\r
-       {\r
-               pDst[0]                         = '\0';\r
-               std::basic_string<char>::traits_type::copy(pDst, pSrc, nChars);\r
-//             std::char_traits<char>::copy(pDst, pSrc, nChars);\r
-               if ( nChars > 0 )\r
-                       pDst[nChars]    = '\0';\r
-       }\r
-\r
-       return pDst;\r
-}\r
-inline PSTR StdCodeCvt(PSTR pDst, PCUSTR pSrc, int nChars)\r
-{\r
-       return StdCodeCvt(pDst, (PCSTR)pSrc, nChars);\r
-}\r
-inline PUSTR StdCodeCvt(PUSTR pDst, PCSTR pSrc, int nChars)\r
-{\r
-       return (PUSTR)StdCodeCvt((PSTR)pDst, pSrc, nChars);\r
-}\r
-\r
-inline PWSTR StdCodeCvt(PWSTR pDst, PCWSTR pSrc, int nChars)\r
-{\r
-       if ( nChars > 0 )\r
-       {\r
-               pDst[0]                         = '\0';\r
-               std::basic_string<wchar_t>::traits_type::copy(pDst, pSrc, nChars);\r
-//             std::char_traits<wchar_t>::copy(pDst, pSrc, nChars);\r
-               if ( nChars > 0 )\r
-                       pDst[nChars]    = '\0';\r
-       }\r
-\r
-       return pDst;\r
-}\r
-\r
-\r
-// Define tstring -- generic name for std::basic_string<TCHAR>\r
-\r
-#if !defined(tstring) && !defined(TSTRING_DEFINED)\r
-       typedef std::basic_string<TCHAR> tstring;\r
-       #define TSTRING_DEFINED\r
-#endif\r
-\r
-// a very shorthand way of applying the fix for KB problem Q172398\r
-// (basic_string assignment bug)\r
-\r
-#if defined ( _MSC_VER ) && ( _MSC_VER < 1200 )\r
-       #define Q172398(x) (x).erase()\r
-#else\r
-       #define Q172398(x)\r
-#endif\r
-\r
-// =============================================================================\r
-// INLINE FUNCTIONS ON WHICH CSTDSTRING RELIES\r
-//\r
-// Usually for generic text mapping, we rely on preprocessor macro definitions\r
-// to map to string functions.  However the CStdStr<> template cannot use\r
-// macro-based generic text mappings because its character types do not get\r
-// resolved until template processing which comes AFTER macro processing.  In\r
-// other words, UNICODE is of little help to us in the CStdStr template\r
-//\r
-// Therefore, to keep the CStdStr declaration simple, we have these inline\r
-// functions.  The template calls them often.  Since they are inline (and NOT\r
-// exported when this is built as a DLL), they will probably be resolved away\r
-// to nothing. \r
-//\r
-// Without these functions, the CStdStr<> template would probably have to broken\r
-// out into two, almost identical classes.  Either that or it would be a huge,\r
-// convoluted mess, with tons of "if" statements all over the place checking the\r
-// size of template parameter CT.\r
-// \r
-// In several cases, you will see two versions of each function.  One version is\r
-// the more portable, standard way of doing things, while the other is the\r
-// non-standard, but often significantly faster Visual C++ way.\r
-// =============================================================================\r
-\r
-// If they defined SS_NO_REFCOUNT, then we must convert all assignments\r
-\r
-#ifdef SS_NO_REFCOUNT\r
-       #define SSREF(x) (x).c_str()\r
-#else\r
-       #define SSREF(x) (x)\r
-#endif\r
-\r
-// -----------------------------------------------------------------------------\r
-// sslen: strlen/wcslen wrappers\r
-// -----------------------------------------------------------------------------\r
-template<typename CT> inline int sslen(const CT* pT)\r
-{\r
-       return 0 == pT ? 0 : std::basic_string<CT>::traits_type::length(pT);\r
-//     return 0 == pT ? 0 : std::char_traits<CT>::length(pT);\r
-}\r
-inline SS_NOTHROW int sslen(const std::string& s)\r
-{\r
-       return s.length();\r
-}\r
-inline SS_NOTHROW int sslen(const std::wstring& s)\r
-{\r
-       return s.length();\r
-}\r
-\r
-// -----------------------------------------------------------------------------\r
-// sstolower/sstoupper -- convert characters to upper/lower case\r
-// -----------------------------------------------------------------------------\r
-template<typename CT>\r
-inline CT sstolower(const CT& t, const std::locale& loc = std::locale())\r
-{\r
-       return std::tolower<CT>(t, loc);\r
-}\r
-template<typename CT>\r
-inline CT sstoupper(const CT& t, const std::locale& loc = std::locale())\r
-{\r
-       return std::toupper<CT>(t, loc);\r
-}\r
-\r
-// -----------------------------------------------------------------------------\r
-// ssasn: assignment functions -- assign "sSrc" to "sDst"\r
-// -----------------------------------------------------------------------------\r
-typedef std::string::size_type         SS_SIZETYPE; // just for shorthand, really\r
-typedef std::string::pointer           SS_PTRTYPE;  \r
-typedef std::wstring::size_type                SW_SIZETYPE;\r
-typedef std::wstring::pointer          SW_PTRTYPE;  \r
-\r
-inline void    ssasn(std::string& sDst, const std::string& sSrc)\r
-{\r
-       if ( sDst.c_str() != sSrc.c_str() )\r
-       {\r
-               sDst.erase();\r
-               sDst.assign(SSREF(sSrc));\r
-       }\r
-}\r
-inline void    ssasn(std::string& sDst, PCSTR pA)\r
-{\r
-       // Watch out for NULLs, as always.\r
-\r
-       if ( 0 == pA )\r
-       {\r
-               sDst.erase();\r
-       }\r
-\r
-       // If pA actually points to part of sDst, we must NOT erase(), but\r
-       // rather take a substring\r
-\r
-       else if ( pA >= sDst.c_str() && pA <= sDst.c_str() + sDst.size() )\r
-       {\r
-               sDst =sDst.substr(static_cast<SS_SIZETYPE>(pA-sDst.c_str()));\r
-       }\r
-\r
-       // Otherwise (most cases) apply the assignment bug fix, if applicable\r
-       // and do the assignment\r
-\r
-       else\r
-       {\r
-               Q172398(sDst);\r
-               sDst.assign(pA);\r
-       }\r
-}\r
-inline void    ssasn(std::string& sDst, const std::wstring& sSrc)\r
-{\r
-       int nLen        = sSrc.size();\r
-       sDst.resize(nLen * sizeof(wchar_t) + 1);\r
-       StdCodeCvt(const_cast<SS_PTRTYPE>(sDst.data()), sSrc.c_str(), nLen);\r
-       sDst.resize(nLen);\r
-       //sDst.resize(sslen(sDst.c_str()));\r
-}\r
-inline void    ssasn(std::string& sDst, PCWSTR pW)\r
-{\r
-       int nLen        = sslen(pW);\r
-       sDst.resize(nLen * sizeof(wchar_t) + 1);\r
-       StdCodeCvt(const_cast<SS_PTRTYPE>(sDst.data()), pW, nLen);\r
-       sDst.resize(nLen);\r
-       //sDst.resize(sslen(sDst.c_str()));\r
-}\r
-inline void ssasn(std::string& sDst, const int nNull)\r
-{\r
-       UNUSED(nNull);\r
-       ASSERT(nNull==0);\r
-       sDst.assign("");\r
-}      \r
-inline void    ssasn(std::wstring& sDst, const std::wstring& sSrc)\r
-{\r
-       if ( sDst.c_str() != sSrc.c_str() )\r
-       {\r
-               sDst.erase();\r
-               sDst.assign(SSREF(sSrc));\r
-       }\r
-}\r
-inline void    ssasn(std::wstring& sDst, PCWSTR pW)\r
-{\r
-       // Watch out for NULLs, as always.\r
-\r
-       if ( 0 == pW )\r
-       {\r
-               sDst.erase();\r
-       }\r
-\r
-       // If pW actually points to part of sDst, we must NOT erase(), but\r
-       // rather take a substring\r
-\r
-       else if ( pW >= sDst.c_str() && pW <= sDst.c_str() + sDst.size() )\r
-       {\r
-               sDst = sDst.substr(static_cast<SW_SIZETYPE>(pW-sDst.c_str()));\r
-       }\r
-\r
-       // Otherwise (most cases) apply the assignment bug fix, if applicable\r
-       // and do the assignment\r
-\r
-       else\r
-       {\r
-               Q172398(sDst);\r
-               sDst.assign(pW);\r
-       }\r
-}\r
-#undef StrSizeType\r
-inline void    ssasn(std::wstring& sDst, const std::string& sSrc)\r
-{\r
-       int nLen        = sSrc.size();\r
-       sDst.resize(nLen+1);\r
-       StdCodeCvt(const_cast<SW_PTRTYPE>(sDst.data()), sSrc.c_str(), nLen+1);\r
-       sDst.resize(sslen(sDst.c_str()));\r
-}\r
-inline void    ssasn(std::wstring& sDst, PCSTR pA)\r
-{\r
-       int nLen        = sslen(pA);\r
-       sDst.resize(nLen+1);\r
-       StdCodeCvt(const_cast<SW_PTRTYPE>(sDst.data()), pA, nLen+1);\r
-       sDst.resize(sslen(sDst.c_str()));\r
-}\r
-inline void ssasn(std::wstring& sDst, const int nNull)\r
-{\r
-       UNUSED(nNull);\r
-       ASSERT(nNull==0);\r
-       sDst.assign(L"");\r
-}\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// ssadd: string object concatenation -- add second argument to first\r
-// -----------------------------------------------------------------------------\r
-inline void    ssadd(std::string& sDst, const std::wstring& sSrc)\r
-{\r
-       int nSrcLen     = sSrc.size();\r
-       int nDstLen     = sDst.size();\r
-       int nEndLen     = nSrcLen + nDstLen;\r
-       sDst.resize(nEndLen + 1);\r
-       StdCodeCvt(const_cast<SS_PTRTYPE>(sDst.data()+nDstLen), sSrc.c_str(), nSrcLen);\r
-       sDst.resize(nEndLen);\r
-}\r
-inline void    ssadd(std::string& sDst, const std::string& sSrc)\r
-{\r
-       if ( &sDst == &sSrc )\r
-               sDst.reserve(2*sDst.size());\r
-\r
-       sDst.append(sSrc.c_str());\r
-}\r
-inline void    ssadd(std::string& sDst, PCWSTR pW)\r
-{\r
-       int nSrcLen     = sslen(pW);\r
-       int nDstLen     = sDst.size();\r
-       int nEndLen     = nSrcLen + nDstLen;\r
-       sDst.resize(nEndLen + 1);\r
-       StdCodeCvt(const_cast<SS_PTRTYPE>(sDst.data()+nDstLen), pW, nSrcLen+1);\r
-       sDst.resize(nEndLen);\r
-}\r
-inline void    ssadd(std::string& sDst, PCSTR pA)\r
-{\r
-       if ( pA )\r
-       {\r
-               // If the string being added is our internal string or a part of our\r
-               // internal string, then we must NOT do any reallocation without\r
-               // first copying that string to another object (since we're using a\r
-               // direct pointer)\r
-\r
-               if ( pA >= sDst.c_str() && pA <= sDst.c_str()+sDst.length())\r
-               {\r
-                       if ( sDst.capacity() <= sDst.size()+sslen(pA) )\r
-                               sDst.append(std::string(pA));\r
-                       else\r
-                               sDst.append(pA);\r
-               }\r
-               else\r
-               {\r
-                       sDst.append(pA); \r
-               }\r
-       }\r
-}\r
-inline void    ssadd(std::wstring& sDst, const std::wstring& sSrc)\r
-{\r
-       if ( &sDst == &sSrc )\r
-               sDst.reserve(2*sDst.size());\r
-\r
-       sDst.append(sSrc.c_str());\r
-}\r
-inline void    ssadd(std::wstring& sDst, const std::string& sSrc)\r
-{\r
-       int nSrcLen     = sSrc.size();\r
-       int nDstLen     = sDst.size();\r
-       int nEndLen     = nSrcLen + nDstLen;\r
-       sDst.resize(nEndLen+1);\r
-       StdCodeCvt(const_cast<SW_PTRTYPE>(sDst.data()+nDstLen), sSrc.c_str(), nSrcLen+1);\r
-       sDst.resize(nEndLen);\r
-}\r
-inline void    ssadd(std::wstring& sDst, PCSTR pA)\r
-{\r
-       int nSrcLen     = sslen(pA);\r
-       int nDstLen     = sDst.size();\r
-       int nEndLen     = nSrcLen + nDstLen;\r
-       sDst.resize(nEndLen + 1);\r
-       StdCodeCvt(const_cast<SW_PTRTYPE>(sDst.data()+nDstLen), pA, nSrcLen+1);\r
-       sDst.resize(nEndLen);\r
-}\r
-inline void    ssadd(std::wstring& sDst, PCWSTR pW)\r
-{\r
-       if ( pW )\r
-       {\r
-               // If the string being added is our internal string or a part of our\r
-               // internal string, then we must NOT do any reallocation without\r
-               // first copying that string to another object (since we're using a\r
-               // direct pointer)\r
-\r
-               if ( pW >= sDst.c_str() && pW <= sDst.c_str()+sDst.length())\r
-               {\r
-                       if ( sDst.capacity() <= sDst.size()+sslen(pW) )\r
-                               sDst.append(std::wstring(pW));\r
-                       else\r
-                               sDst.append(pW);\r
-               }\r
-               else\r
-               {\r
-                       sDst.append(pW);\r
-               }\r
-       }\r
-}\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// ssicmp: comparison (case insensitive )\r
-// -----------------------------------------------------------------------------\r
-template<typename CT>\r
-inline int ssicmp(const CT* pA1, const CT* pA2)\r
-{\r
-    std::locale loc;\r
-    const std::ctype<CT>& ct = SS_USE_FACET(loc, std::ctype<CT>);\r
-    CT f;\r
-    CT l;\r
-\r
-    do \r
-    {\r
-           f = ct.tolower(*(pA1++));\r
-           l = ct.tolower(*(pA2++));\r
-    } while ( (f) && (f == l) );\r
-\r
-    return (int)(f - l);\r
-}\r
-\r
-// -----------------------------------------------------------------------------\r
-// ssupr/sslwr: Uppercase/Lowercase conversion functions\r
-// -----------------------------------------------------------------------------\r
-\r
-template<typename CT>\r
-inline void sslwr(CT* pT, size_t nLen)\r
-{\r
-       SS_USE_FACET(std::locale(), std::ctype<CT>).tolower(pT, pT+nLen);\r
-}\r
-template<typename CT>\r
-inline void ssupr(CT* pT, size_t nLen)\r
-{\r
-       SS_USE_FACET(std::locale(), std::ctype<CT>).toupper(pT, pT+nLen);\r
-}\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-//  vsprintf/vswprintf or _vsnprintf/_vsnwprintf equivalents.  In standard\r
-//  builds we can't use _vsnprintf/_vsnwsprintf because they're MS extensions.\r
-// -----------------------------------------------------------------------------\r
-#if defined(SS_ANSI) || !defined(_MSC_VER)\r
-\r
-    // Borland's headers put some ANSI "C" functions in the 'std' namespace.\r
-    // Promote them to the global namespace so we can use them here.\r
-\r
-    #if defined(__BORLANDC__)\r
-        using std::vsprintf;\r
-        using std::vswprintf;\r
-    #endif\r
-       inline int ssvsprintf(PSTR pA, size_t /*nCount*/, PCSTR pFmtA, va_list vl)\r
-       {\r
-               return vsprintf(pA, pFmtA, vl);\r
-       }\r
-       inline int ssvsprintf(PWSTR pW, size_t nCount, PCWSTR pFmtW, va_list vl)\r
-       {\r
-               // JMO: Some distributions of the "C" have a version of vswprintf that\r
-        // takes 3 arguments (e.g. Microsoft, Borland, GNU).  Others have a \r
-        // version which takes 4 arguments (an extra "count" argument in the\r
-        // second position.  The best stab I can take at this so far is that if\r
-        // you are NOT running with MS, Borland, or GNU, then I'll assume you\r
-        // have the version that takes 4 arguments.\r
-        //\r
-        // I'm sure that these checks don't catch every platform correctly so if\r
-        // you get compiler errors on one of the lines immediately below, it's\r
-        // probably because your implemntation takes a different number of\r
-        // arguments.  You can comment out the offending line (and use the\r
-        // alternate version) or you can figure out what compiler flag to check\r
-        // and add that preprocessor check in.  Regardless, if you get an error\r
-        // on these lines, I'd sure like to hear from you about it.\r
-        //\r
-        // Thanks to Ronny Schulz for the SGI-specific checks here.\r
-\r
-//     #if !defined(__MWERKS__) && !defined(__SUNPRO_CC_COMPAT) && !defined(__SUNPRO_CC)\r
-    #if    !defined(_MSC_VER) \\r
-        && !defined (__BORLANDC__) \\r
-        && !defined(__GNUC__) \\r
-        && !defined(__sgi)\r
-\r
-        return vswprintf(pW, nCount, pFmtW, vl);\r
-\r
-    // suddenly with the current SGI 7.3 compiler there is no such function as\r
-    // vswprintf and the substitute needs explicit casts to compile\r
-\r
-    #elif defined(__sgi)\r
-\r
-        nCount;\r
-        return vsprintf( (char *)pW, (char *)pFmtW, vl);\r
-\r
-    #else\r
-\r
-        nCount;\r
-        return vswprintf(pW, pFmtW, vl);\r
-\r
-    #endif\r
-\r
-       }\r
-#else\r
-       inline int      ssnprintf(PSTR pA, size_t nCount, PCSTR pFmtA, va_list vl)\r
-       {\r
-               return _vsnprintf(pA, nCount, pFmtA, vl);\r
-       }\r
-       inline int      ssnprintf(PWSTR pW, size_t nCount, PCWSTR pFmtW, va_list vl)\r
-       {\r
-               return _vsnwprintf(pW, nCount, pFmtW, vl);\r
-       }\r
-#endif\r
-\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// ssload: Type safe, overloaded ::LoadString wrappers\r
-// There is no equivalent of these in non-Win32-specific builds.  However, I'm\r
-// thinking that with the message facet, there might eventually be one\r
-// -----------------------------------------------------------------------------\r
-#if defined (SS_WIN32) && !defined(SS_ANSI)\r
-       inline int ssload(HMODULE hInst, UINT uId, PSTR pBuf, int nMax)\r
-       {\r
-               return ::LoadStringA(hInst, uId, pBuf, nMax);\r
-       }\r
-       inline int ssload(HMODULE hInst, UINT uId, PWSTR pBuf, int nMax)\r
-       {\r
-               return ::LoadStringW(hInst, uId, pBuf, nMax);\r
-       }\r
-#endif\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// sscoll/ssicoll: Collation wrappers\r
-//             Note -- with MSVC I have reversed the arguments order here because the\r
-//             functions appear to return the opposite of what they should\r
-// -----------------------------------------------------------------------------\r
-template <typename CT>\r
-inline int sscoll(const CT* sz1, int nLen1, const CT* sz2, int nLen2)\r
-{\r
-       const std::collate<CT>& coll =\r
-               SS_USE_FACET(std::locale(), std::collate<CT>);\r
-\r
-       return coll.compare(sz2, sz2+nLen2, sz1, sz1+nLen1);\r
-}\r
-template <typename CT>\r
-inline int ssicoll(const CT* sz1, int nLen1, const CT* sz2, int nLen2)\r
-{\r
-       const std::locale loc;\r
-       const std::collate<CT>& coll = SS_USE_FACET(loc, std::collate<CT>);\r
-\r
-       // Some implementations seem to have trouble using the collate<>\r
-       // facet typedefs so we'll just default to basic_string and hope\r
-       // that's what the collate facet uses (which it generally should)\r
-\r
-//     std::collate<CT>::string_type s1(sz1);\r
-//     std::collate<CT>::string_type s2(sz2);\r
-       const std::basic_string<CT> sEmpty;\r
-    std::basic_string<CT> s1(sz1 ? sz1 : sEmpty.c_str());\r
-    std::basic_string<CT> s2(sz2 ? sz2 : sEmpty.c_str());\r
-\r
-       sslwr(const_cast<CT*>(s1.c_str()), nLen1);\r
-       sslwr(const_cast<CT*>(s2.c_str()), nLen2);\r
-       return coll.compare(s2.c_str(), s2.c_str()+nLen2,\r
-                                               s1.c_str(), s1.c_str()+nLen1);\r
-}\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// ssfmtmsg: FormatMessage equivalents.  Needed because I added a CString facade\r
-// Again -- no equivalent of these on non-Win32 builds but their might one day\r
-// be one if the message facet gets implemented\r
-// -----------------------------------------------------------------------------\r
-#if defined (SS_WIN32) && !defined(SS_ANSI)\r
-       inline DWORD ssfmtmsg(DWORD dwFlags, LPCVOID pSrc, DWORD dwMsgId,\r
-                                                 DWORD dwLangId, PSTR pBuf, DWORD nSize,\r
-                                                 va_list* vlArgs)\r
-       { \r
-               return FormatMessageA(dwFlags, pSrc, dwMsgId, dwLangId,\r
-                                                         pBuf, nSize,vlArgs);\r
-       }\r
-       inline DWORD ssfmtmsg(DWORD dwFlags, LPCVOID pSrc, DWORD dwMsgId,\r
-                                                 DWORD dwLangId, PWSTR pBuf, DWORD nSize,\r
-                                                 va_list* vlArgs)\r
-       {\r
-               return FormatMessageW(dwFlags, pSrc, dwMsgId, dwLangId,\r
-                                                         pBuf, nSize,vlArgs);\r
-       }\r
-#else\r
-#endif\r
\r
-\r
-\r
-// FUNCTION: sscpy.  Copies up to 'nMax' characters from pSrc to pDst.\r
-// -----------------------------------------------------------------------------\r
-// FUNCTION:  sscpy\r
-//             inline int sscpy(PSTR pDst, PCSTR pSrc, int nMax=-1);\r
-//             inline int sscpy(PUSTR pDst,  PCSTR pSrc, int nMax=-1)\r
-//             inline int sscpy(PSTR pDst, PCWSTR pSrc, int nMax=-1);\r
-//             inline int sscpy(PWSTR pDst, PCWSTR pSrc, int nMax=-1);\r
-//             inline int sscpy(PWSTR pDst, PCSTR pSrc, int nMax=-1);\r
-//\r
-// DESCRIPTION:\r
-//             This function is very much (but not exactly) like strcpy.  These\r
-//             overloads simplify copying one C-style string into another by allowing\r
-//             the caller to specify two different types of strings if necessary.\r
-//\r
-//             The strings must NOT overlap\r
-//\r
-//             "Character" is expressed in terms of the destination string, not\r
-//             the source.  If no 'nMax' argument is supplied, then the number of\r
-//             characters copied will be sslen(pSrc).  A NULL terminator will\r
-//             also be added so pDst must actually be big enough to hold nMax+1\r
-//             characters.  The return value is the number of characters copied,\r
-//             not including the NULL terminator.\r
-//\r
-// PARAMETERS: \r
-//             pSrc - the string to be copied FROM.  May be a char based string, an\r
-//                        MBCS string (in Win32 builds) or a wide string (wchar_t).\r
-//             pSrc - the string to be copied TO.  Also may be either MBCS or wide\r
-//             nMax - the maximum number of characters to be copied into szDest.  Note\r
-//                        that this is expressed in whatever a "character" means to pDst.\r
-//                        If pDst is a wchar_t type string than this will be the maximum\r
-//                        number of wchar_ts that my be copied.  The pDst string must be\r
-//                        large enough to hold least nMaxChars+1 characters.\r
-//                        If the caller supplies no argument for nMax this is a signal to\r
-//                        the routine to copy all the characters in pSrc, regardless of\r
-//                        how long it is.\r
-//\r
-// RETURN VALUE: none\r
-// -----------------------------------------------------------------------------\r
-template<typename CT1, typename CT2>\r
-inline int sscpycvt(CT1* pDst, const CT2* pSrc, int nChars)\r
-{\r
-       StdCodeCvt(pDst, pSrc, nChars);\r
-       pDst[SSMAX(nChars, 0)]  = '\0';\r
-       return nChars;\r
-}\r
-\r
-template<typename CT1, typename CT2>\r
-inline int sscpy(CT1* pDst, const CT2* pSrc, int nMax, int nLen)\r
-{\r
-       return sscpycvt(pDst, pSrc, SSMIN(nMax, nLen));\r
-}\r
-template<typename CT1, typename CT2>\r
-inline int sscpy(CT1* pDst, const CT2* pSrc, int nMax)\r
-{\r
-       return sscpycvt(pDst, pSrc, SSMIN(nMax, sslen(pSrc)));\r
-}\r
-template<typename CT1, typename CT2>\r
-inline int sscpy(CT1* pDst, const CT2* pSrc)\r
-{\r
-       return sscpycvt(pDst, pSrc, sslen(pSrc));\r
-}\r
-template<typename CT1, typename CT2>\r
-inline int sscpy(CT1* pDst, const std::basic_string<CT2>& sSrc, int nMax)\r
-{\r
-       return sscpycvt(pDst, sSrc.c_str(), SSMIN(nMax, (int)sSrc.length()));\r
-}\r
-template<typename CT1, typename CT2>\r
-inline int sscpy(CT1* pDst, const std::basic_string<CT2>& sSrc)\r
-{\r
-       return sscpycvt(pDst, sSrc.c_str(), (int)sSrc.length());\r
-}\r
-\r
-#ifdef SS_INC_COMDEF\r
-       template<typename CT1>\r
-       inline int sscpy(CT1* pDst, const _bstr_t& bs, int nMax)\r
-       {\r
-               return sscpycvt(pDst, static_cast<PCOLESTR>(bs),\r
-            SSMIN(nMax, static_cast<int>(bs.length())));\r
-       }\r
-       template<typename CT1>\r
-       inline int sscpy(CT1* pDst, const _bstr_t& bs)\r
-       {\r
-               return sscpy(pDst, bs, static_cast<int>(bs.length()));\r
-       }\r
-#endif\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// Functional objects for changing case.  They also let you pass locales\r
-// -----------------------------------------------------------------------------\r
-\r
-#ifdef SS_ANSI\r
-    template<typename CT>\r
-    struct SSToUpper : public std::binary_function<CT, std::locale, CT>\r
-    {\r
-           inline CT operator()(const CT& t, const std::locale& loc) const\r
-           {\r
-                   return sstoupper<CT>(t, loc);\r
-           }\r
-    };\r
-    template<typename CT>\r
-    struct SSToLower : public std::binary_function<CT, std::locale, CT>\r
-    {\r
-           inline CT operator()(const CT& t, const std::locale& loc) const\r
-           {\r
-                   return sstolower<CT>(t, loc);\r
-           }\r
-    };\r
-#endif\r
-\r
-// This struct is used for TrimRight() and TrimLeft() function implementations.\r
-//template<typename CT>\r
-//struct NotSpace : public std::unary_function<CT, bool>\r
-//{\r
-//     const std::locale& loc;\r
-//     inline NotSpace(const std::locale& locArg) : loc(locArg) {}\r
-//     inline bool operator() (CT t) { return !std::isspace(t, loc); }\r
-//};\r
-template<typename CT>\r
-struct NotSpace : public std::unary_function<CT, bool>\r
-{\r
-\r
-       // DINKUMWARE BUG:\r
-       // Note -- using std::isspace in a COM DLL gives us access violations\r
-       // because it causes the dynamic addition of a function to be called\r
-       // when the library shuts down.  Unfortunately the list is maintained\r
-       // in DLL memory but the function is in static memory.  So the COM DLL\r
-       // goes away along with the function that was supposed to be called,\r
-       // and then later when the DLL CRT shuts down it unloads the list and\r
-       // tries to call the long-gone function.\r
-       // This is DinkumWare's implementation problem.  Until then, we will\r
-       // use good old isspace and iswspace from the CRT unless they\r
-       // specify SS_ANSI\r
-    \r
-       const std::locale loc;\r
-       NotSpace(const std::locale& locArg=std::locale()) : loc(locArg) {}\r
-       bool operator() (CT t) const { return !std::isspace(t, loc); }\r
-};\r
-\r
-\r
-\r
-\r
-//                     Now we can define the template (finally!)\r
-// =============================================================================\r
-// TEMPLATE: CStdStr\r
-//             template<typename CT> class CStdStr : public std::basic_string<CT>\r
-//\r
-// REMARKS:\r
-//             This template derives from basic_string<CT> and adds some MFC CString-\r
-//             like functionality\r
-//\r
-//             Basically, this is my attempt to make Standard C++ library strings as\r
-//             easy to use as the MFC CString class.\r
-//\r
-//             Note that although this is a template, it makes the assumption that the\r
-//             template argument (CT, the character type) is either char or wchar_t.  \r
-// =============================================================================\r
-\r
-//#define CStdStr _SS  // avoid compiler warning 4786\r
-\r
-//    template<typename ARG> ARG& FmtArg(ARG& arg)  { return arg; }\r
-//    PCSTR  FmtArg(const std::string& arg)  { return arg.c_str(); }\r
-//    PCWSTR FmtArg(const std::wstring& arg) { return arg.c_str(); }\r
-\r
-template<typename ARG>\r
-struct FmtArg\r
-{\r
-    explicit FmtArg(const ARG& arg) : a_(arg) {}\r
-    const ARG& Val() const { return a_; }\r
-    const ARG& a_;\r
-private:\r
-    FmtArg& operator=(const FmtArg&) { return *this; }\r
-};\r
-\r
-template<typename CT>\r
-class CStdStr : public std::basic_string<CT>\r
-{\r
-       // Typedefs for shorter names.  Using these names also appears to help\r
-       // us avoid some ambiguities that otherwise arise on some platforms\r
-\r
-       typedef typename std::basic_string<CT>          MYBASE;  // my base class\r
-       typedef CStdStr<CT>                                                     MYTYPE;  // myself\r
-       typedef typename MYBASE::const_pointer          PCMYSTR; // PCSTR or PCWSTR \r
-       typedef typename MYBASE::pointer                        PMYSTR;  // PSTR or PWSTR\r
-       typedef typename MYBASE::iterator                       MYITER;  // my iterator type\r
-       typedef typename MYBASE::const_iterator         MYCITER; // you get the idea...\r
-       typedef typename MYBASE::reverse_iterator       MYRITER;\r
-       typedef typename MYBASE::size_type                      MYSIZE;   \r
-       typedef typename MYBASE::value_type                     MYVAL; \r
-       typedef typename MYBASE::allocator_type         MYALLOC;\r
-       \r
-public:\r
-\r
-       // shorthand conversion from PCTSTR to string resource ID\r
-       #define _TRES(pctstr) (LOWORD((DWORD)(pctstr))) \r
-\r
-       // CStdStr inline constructors\r
-       CStdStr()\r
-       {\r
-       }\r
-\r
-       CStdStr(const MYTYPE& str) : MYBASE(SSREF(str))\r
-       {\r
-       }\r
-\r
-       CStdStr(const std::string& str)\r
-       {\r
-               ssasn(*this, SSREF(str));\r
-       }\r
-\r
-       CStdStr(const std::wstring& str)\r
-       {\r
-               ssasn(*this, SSREF(str));\r
-       }\r
-\r
-       CStdStr(PCMYSTR pT, MYSIZE n) : MYBASE(pT, n)\r
-       {\r
-       }\r
-\r
-#ifdef SS_UNSIGNED\r
-       CStdStr(PCUSTR pU)\r
-       {\r
-               *this = reinterpret_cast<PCSTR>(pU);\r
-       }\r
-#endif\r
-\r
-       CStdStr(PCSTR pA)\r
-       {\r
-       #ifdef SS_ANSI\r
-               *this = pA;\r
-       #else\r
-               if ( 0 != HIWORD(pA) )\r
-                       *this = pA;\r
-               else if ( 0 != pA && !Load(_TRES(pA)) )\r
-                       TRACE(_T("Can't load string %u\n"), _TRES(pA));\r
-       #endif\r
-       }\r
-\r
-       CStdStr(PCWSTR pW)\r
-       {\r
-       #ifdef SS_ANSI\r
-               *this = pW;\r
-       #else\r
-               if ( 0 != HIWORD(pW) )\r
-                       *this = pW;\r
-               else if ( 0 != pW && !Load(_TRES(pW)) )\r
-                       TRACE(_T("Can't load string %u\n"), _TRES(pW));\r
-       #endif\r
-       }\r
-\r
-       CStdStr(MYCITER first, MYCITER last)\r
-               : MYBASE(first, last)\r
-       {\r
-       }\r
-\r
-       CStdStr(MYSIZE nSize, MYVAL ch, const MYALLOC& al=MYALLOC())\r
-               : MYBASE(nSize, ch, al)\r
-       {\r
-       }\r
-\r
-       #ifdef SS_INC_COMDEF\r
-               CStdStr(const _bstr_t& bstr)\r
-               {\r
-                       if ( bstr.length() > 0 )\r
-                               this->append(static_cast<PCMYSTR>(bstr), bstr.length());\r
-               }\r
-       #endif\r
-\r
-       // CStdStr inline assignment operators -- the ssasn function now takes care\r
-       // of fixing  the MSVC assignment bug (see knowledge base article Q172398).\r
-       MYTYPE& operator=(const MYTYPE& str)\r
-       { \r
-               ssasn(*this, str); \r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator=(const std::string& str)\r
-       {\r
-               ssasn(*this, str);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator=(const std::wstring& str)\r
-       {\r
-               ssasn(*this, str);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator=(PCSTR pA)\r
-       {\r
-               ssasn(*this, pA);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator=(PCWSTR pW)\r
-       {\r
-               ssasn(*this, pW);\r
-               return *this;\r
-       }\r
-\r
-#ifdef SS_UNSIGNED\r
-       MYTYPE& operator=(PCUSTR pU)\r
-       {\r
-               ssasn(*this, reinterpret_cast<PCSTR>(pU)):\r
-               return *this;\r
-       }\r
-#endif\r
-\r
-       MYTYPE& operator=(CT t)\r
-       {\r
-               Q172398(*this);\r
-               this->assign(1, t);\r
-               return *this;\r
-       }\r
-\r
-       #ifdef SS_INC_COMDEF\r
-               MYTYPE& operator=(const _bstr_t& bstr)\r
-               {\r
-                       if ( bstr.length() > 0 )\r
-                       {\r
-                               this->assign(static_cast<PCMYSTR>(bstr), bstr.length());\r
-                               return *this;\r
-                       }\r
-                       else\r
-                       {\r
-                               this->erase();\r
-                               return *this;\r
-                       }\r
-               }\r
-       #endif\r
-\r
-\r
-       // Overloads  also needed to fix the MSVC assignment bug (KB: Q172398)\r
-       //  *** Thanks to Pete The Plumber for catching this one ***\r
-       // They also are compiled if you have explicitly turned off refcounting\r
-       #if ( defined(_MSC_VER) && ( _MSC_VER < 1200 ) ) || defined(SS_NO_REFCOUNT) \r
-\r
-               MYTYPE& assign(const MYTYPE& str)\r
-               {\r
-                       ssasn(*this, str);\r
-                       return *this;\r
-               }\r
-\r
-               MYTYPE& assign(const MYTYPE& str, MYSIZE nStart, MYSIZE nChars)\r
-               {\r
-                       // This overload of basic_string::assign is supposed to assign up to\r
-                       // <nChars> or the NULL terminator, whichever comes first.  Since we\r
-                       // are about to call a less forgiving overload (in which <nChars>\r
-                       // must be a valid length), we must adjust the length here to a safe\r
-                       // value.  Thanks to Ullrich Pollähne for catching this bug\r
-\r
-                       nChars          = SSMIN(nChars, str.length() - nStart);\r
-\r
-                       // Watch out for assignment to self\r
-\r
-                       if ( this == &str )\r
-                       {\r
-                               MYTYPE strTemp(str.c_str()+nStart, nChars);\r
-                               MYBASE::assign(strTemp);\r
-                       }\r
-                       else\r
-                       {\r
-                               Q172398(*this);\r
-                               MYBASE::assign(str.c_str()+nStart, nChars);\r
-                       }\r
-                       return *this;\r
-               }\r
-\r
-               MYTYPE& assign(const MYBASE& str)\r
-               {\r
-                       ssasn(*this, str);\r
-                       return *this;\r
-               }\r
-\r
-               MYTYPE& assign(const MYBASE& str, MYSIZE nStart, MYSIZE nChars)\r
-               {\r
-                       // This overload of basic_string::assign is supposed to assign up to\r
-                       // <nChars> or the NULL terminator, whichever comes first.  Since we\r
-                       // are about to call a less forgiving overload (in which <nChars>\r
-                       // must be a valid length), we must adjust the length here to a safe\r
-                       // value. Thanks to Ullrich Pollähne for catching this bug\r
-\r
-                       nChars          = SSMIN(nChars, str.length() - nStart);\r
-\r
-                       // Watch out for assignment to self\r
-\r
-                       if ( this == &str )     // watch out for assignment to self\r
-                       {\r
-                               MYTYPE strTemp(str.c_str() + nStart, nChars);\r
-                               MYBASE::assign(strTemp);\r
-                       }\r
-                       else\r
-                       {\r
-                               Q172398(*this);\r
-                               MYBASE::assign(str.c_str()+nStart, nChars);\r
-                       }\r
-                       return *this;\r
-               }\r
-\r
-               MYTYPE& assign(const CT* pC, MYSIZE nChars)\r
-               {\r
-                       // Q172398 only fix -- erase before assigning, but not if we're\r
-                       // assigning from our own buffer\r
-\r
-       #if defined ( _MSC_VER ) && ( _MSC_VER < 1200 )\r
-                       if ( !this->empty() &&\r
-                               ( pC < this->data() || pC > this->data() + this->capacity() ) )\r
-                       {\r
-                               this->erase();\r
-                       }\r
-       #endif\r
-                       Q172398(*this);\r
-                       MYBASE::assign(pC, nChars);\r
-                       return *this;\r
-               }\r
-\r
-               MYTYPE& assign(MYSIZE nChars, MYVAL val)\r
-               {\r
-                       Q172398(*this);\r
-                       MYBASE::assign(nChars, val);\r
-                       return *this;\r
-               }\r
-\r
-               MYTYPE& assign(const CT* pT)\r
-               {\r
-                       return this->assign(pT, MYBASE::traits_type::length(pT));\r
-               }\r
-\r
-               MYTYPE& assign(MYCITER iterFirst, MYCITER iterLast)\r
-               {\r
-       #if defined ( _MSC_VER ) && ( _MSC_VER < 1200 ) \r
-                       // Q172398 fix.  don't call erase() if we're assigning from ourself\r
-                       if ( iterFirst < this->begin() ||\r
-                 iterFirst > this->begin() + this->size() )\r
-            {\r
-                               this->erase()\r
-            }\r
-       #endif\r
-                       this->replace(this->begin(), this->end(), iterFirst, iterLast);\r
-                       return *this;\r
-               }\r
-       #endif\r
-\r
-\r
-       // -------------------------------------------------------------------------\r
-       // CStdStr inline concatenation.\r
-       // -------------------------------------------------------------------------\r
-       MYTYPE& operator+=(const MYTYPE& str)\r
-       {\r
-               ssadd(*this, str);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator+=(const std::string& str)\r
-       {\r
-               ssadd(*this, str);\r
-               return *this; \r
-       }\r
-\r
-       MYTYPE& operator+=(const std::wstring& str)\r
-       {\r
-               ssadd(*this, str);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator+=(PCSTR pA)\r
-       {\r
-               ssadd(*this, pA);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator+=(PCWSTR pW)\r
-       {\r
-               ssadd(*this, pW);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& operator+=(CT t)\r
-       {\r
-               this->append(1, t);\r
-               return *this;\r
-       }\r
-       #ifdef SS_INC_COMDEF    // if we have _bstr_t, define a += for it too.\r
-               MYTYPE& operator+=(const _bstr_t& bstr)\r
-               {\r
-                       return this->operator+=(static_cast<PCMYSTR>(bstr));\r
-               }\r
-       #endif\r
-\r
-\r
-       // -------------------------------------------------------------------------\r
-       // Case changing functions\r
-       // -------------------------------------------------------------------------\r
-\r
-    MYTYPE& ToUpper()\r
-       {\r
-               //  Strictly speaking, this would be about the most portable way\r
-\r
-               //      std::transform(begin(),\r
-               //                                 end(),\r
-               //                                 begin(),\r
-               //                                 std::bind2nd(SSToUpper<CT>(), std::locale()));\r
-\r
-               // But practically speaking, this works faster\r
-\r
-               if ( !empty() )\r
-                       ssupr(GetBuf(), this->size());\r
-\r
-               return *this;\r
-       }\r
-\r
-\r
-\r
-       MYTYPE& ToLower()\r
-       {\r
-               //  Strictly speaking, this would be about the most portable way\r
-\r
-               //      std::transform(begin(),\r
-               //                                 end(),\r
-               //                                 begin(),\r
-               //                                 std::bind2nd(SSToLower<CT>(), std::locale()));\r
-\r
-               // But practically speaking, this works faster\r
-\r
-               if ( !empty() )\r
-                       sslwr(GetBuf(), this->size());\r
-\r
-               return *this;\r
-       }\r
-\r
-\r
-\r
-       MYTYPE& Normalize()\r
-       {\r
-               return Trim().ToLower();\r
-       }\r
-\r
-\r
-       // -------------------------------------------------------------------------\r
-       // CStdStr -- Direct access to character buffer.  In the MS' implementation,\r
-       // the at() function that we use here also calls _Freeze() providing us some\r
-       // protection from multithreading problems associated with ref-counting.\r
-    // In VC 7 and later, of course, the ref-counting stuff is gone.\r
-       // -------------------------------------------------------------------------\r
-\r
-       CT* GetBuf(int nMinLen=-1)\r
-       {\r
-               if ( static_cast<int>(size()) < nMinLen )\r
-                       this->resize(static_cast<MYSIZE>(nMinLen));\r
-\r
-               return this->empty() ? const_cast<CT*>(this->data()) : &(this->at(0));\r
-       }\r
-\r
-       CT* SetBuf(int nLen)\r
-       {\r
-               nLen = ( nLen > 0 ? nLen : 0 );\r
-               if ( this->capacity() < 1 && nLen == 0 )\r
-                       this->resize(1);\r
-\r
-               this->resize(static_cast<MYSIZE>(nLen));\r
-               return const_cast<CT*>(this->data());\r
-       }\r
-       void RelBuf(int nNewLen=-1)\r
-       {\r
-               this->resize(static_cast<MYSIZE>(nNewLen > -1 ? nNewLen :\r
-                                                        sslen(this->c_str())));\r
-       }\r
-\r
-       void BufferRel()                 { RelBuf(); }                  // backwards compatability\r
-       CT*  Buffer()                    { return GetBuf(); }   // backwards compatability\r
-       CT*  BufferSet(int nLen) { return SetBuf(nLen);}// backwards compatability\r
-\r
-       bool Equals(const CT* pT, bool bUseCase=false) const\r
-       {       // get copy, THEN compare (thread safe)\r
-               return  bUseCase ? this->compare(pT) == 0 :\r
-                           ssicmp(MYTYPE(*this).c_str(), pT) == 0;\r
-       } \r
-\r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION:  CStdStr::Load\r
-       // REMARKS:\r
-       //              Loads string from resource specified by nID\r
-       //\r
-       // PARAMETERS:\r
-       //              nID - resource Identifier.  Purely a Win32 thing in this case\r
-       //\r
-       // RETURN VALUE:\r
-       //              true if successful, false otherwise\r
-       // -------------------------------------------------------------------------\r
-\r
-#ifndef SS_ANSI\r
-\r
-       bool Load(UINT nId, HMODULE hModule=NULL)\r
-       {\r
-               bool bLoaded            = false;        // set to true of we succeed.\r
-\r
-       #ifdef _MFC_VER         // When in Rome (or MFC land)...\r
-\r
-               CString strRes;\r
-               bLoaded                         = FALSE != strRes.LoadString(nId);\r
-               if ( bLoaded )\r
-                       *this                   = strRes;\r
-\r
-       #else // otherwise make our own hackneyed version of CString's Load\r
-               \r
-               // Get the resource name and module handle\r
-\r
-               if ( NULL == hModule )\r
-                       hModule                 = GetResourceHandle();\r
-\r
-               PCTSTR szName           = MAKEINTRESOURCE((nId>>4)+1); // lifted \r
-               DWORD dwSize            = 0;\r
-\r
-               // No sense continuing if we can't find the resource\r
-\r
-               HRSRC hrsrc                     = ::FindResource(hModule, szName, RT_STRING);\r
-\r
-               if ( NULL == hrsrc )\r
-               {\r
-                       TRACE(_T("Cannot find resource %d: 0x%X"), nId, ::GetLastError());\r
-               }\r
-               else if ( 0 == (dwSize = ::SizeofResource(hModule, hrsrc) / sizeof(CT)))\r
-               {\r
-                       TRACE(_T("Cant get size of resource %d 0x%X\n"),nId,GetLastError());\r
-               }\r
-               else\r
-               {\r
-                       bLoaded                 = 0 != ssload(hModule, nId, GetBuf(dwSize), dwSize);\r
-                       ReleaseBuffer();\r
-               }\r
-\r
-       #endif  // #ifdef _MFC_VER\r
-\r
-               if ( !bLoaded )\r
-                       TRACE(_T("String not loaded 0x%X\n"), ::GetLastError());\r
-\r
-               return bLoaded;\r
-       }\r
-\r
-#endif  // #ifdef SS_ANSI\r
-       \r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION:  CStdStr::Format\r
-       //              void _cdecl Formst(CStdStringA& PCSTR szFormat, ...)\r
-       //              void _cdecl Format(PCSTR szFormat);\r
-       //           \r
-       // DESCRIPTION:\r
-       //              This function does sprintf/wsprintf style formatting on CStdStringA\r
-       //              objects.  It looks a lot like MFC's CString::Format.  Some people\r
-       //              might even call this identical.  Fortunately, these people are now\r
-       //              dead... heh heh.\r
-       //\r
-       // PARAMETERS: \r
-       //              nId - ID of string resource holding the format string\r
-       //              szFormat - a PCSTR holding the format specifiers\r
-       //              argList - a va_list holding the arguments for the format specifiers.\r
-       //\r
-       // RETURN VALUE:  None.\r
-       // -------------------------------------------------------------------------\r
-       // formatting (using wsprintf style formatting)\r
-\r
-    // If they want a Format() function that safely handles string objects\r
-    // without casting\r
\r
-#ifdef SS_SAFE_FORMAT       \r
-    \r
-    // Question:  Joe, you wacky coder you, why do you have so many overloads\r
-    //      of the Format() function\r
-    // Answer:  One reason only - CString compatability.  In short, by making\r
-    //      the Format() function a template this way, I can do strong typing\r
-    //      and allow people to pass CStdString arguments as fillers for\r
-    //      "%s" format specifiers without crashing their program!  The downside\r
-    //      is that I need to overload on the number of arguments.   If you are\r
-    //      passing more arguments than I have listed below in any of my\r
-    //      overloads, just add another one.\r
-    //\r
-    //      Yes, yes, this is really ugly.  In essence what I am doing here is\r
-    //      protecting people from a bad (and incorrect) programming practice\r
-    //      that they should not be doing anyway.  I am protecting them from\r
-    //      themselves.  Why am I doing this?  Well, if you had any idea the\r
-    //      number of times I've been emailed by people about this\r
-    //      "incompatability" in my code, you wouldn't ask.\r
-\r
-       void Fmt(const CT* szFmt, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, szFmt);\r
-               FormatV(szFmt, argList);\r
-               va_end(argList);\r
-       }\r
-\r
-#ifndef SS_ANSI\r
-\r
-    void Format(UINT nId)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) ) \r
-            this->swap(strFmt);\r
-    }\r
-    template<class A1>\r
-    void Format(UINT nId, const A1& v)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-            Fmt(strFmt, FmtArg<A1>(v).Val());\r
-    }\r
-    template<class A1, class A2>\r
-    void Format(UINT nId, const A1& v1, const A2& v2)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-           Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val());\r
-    }\r
-    template<class A1, class A2, class A3>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(),FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(),FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-           Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(),FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-                FmtArg<A12>(v12).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-                FmtArg<A12>(v12).Val(), FmtArg<A13>(v13).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-                FmtArg<A12>(v12).Val(), FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14, class A15>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14, const A15& v15)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-                FmtArg<A12>(v12).Val(),FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val(),\r
-                FmtArg<A15>(v15).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14, class A15, class A16>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14, const A15& v15,\r
-                const A16& v16)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-                FmtArg<A12>(v12).Val(),FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val(),\r
-                FmtArg<A15>(v15).Val(), FmtArg<A16>(v16).Val());\r
-        }\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14, class A15, class A16, class A17>\r
-    void Format(UINT nId, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14, const A15& v15,\r
-                const A16& v16, const A17& v17)\r
-    {\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-        {\r
-            Fmt(strFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-                FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-                FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-                FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-                FmtArg<A12>(v12).Val(),FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val(),\r
-                FmtArg<A15>(v15).Val(),FmtArg<A16>(v16).Val(),FmtArg<A17>(v17).Val());\r
-        }\r
-    }\r
-    \r
-#endif // #ifndef SS_ANSI\r
-\r
-    // ...now the other overload of Format: the one that takes a string literal\r
-\r
-    void Format(const CT* szFmt)\r
-    {\r
-        *this = szFmt;\r
-    }\r
-    template<class A1>\r
-    void Format(const CT* szFmt, A1 v)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v).Val());\r
-    }\r
-    template<class A1, class A2>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val());\r
-    }\r
-    template<class A1, class A2, class A3>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(),FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-            FmtArg<A12>(v12).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-            FmtArg<A12>(v12).Val(), FmtArg<A13>(v13).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-            FmtArg<A12>(v12).Val(), FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14, class A15>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14, const A15& v15)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-            FmtArg<A12>(v12).Val(),FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val(),\r
-            FmtArg<A15>(v15).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14, class A15, class A16>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14, const A15& v15,\r
-                const A16& v16)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-            FmtArg<A12>(v12).Val(),FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val(),\r
-            FmtArg<A15>(v15).Val(), FmtArg<A16>(v16).Val());\r
-    }\r
-    template<class A1, class A2, class A3, class A4, class A5, class A6,\r
-        class A7, class A8, class A9, class A10, class A11, class A12,\r
-        class A13, class A14, class A15, class A16, class A17>\r
-    void Format(const CT* szFmt, const A1& v1, const A2& v2, const A3& v3,\r
-                const A4& v4, const A5& v5, const A6& v6, const A7& v7,\r
-                const A8& v8, const A9& v9, const A10& v10, const A11& v11,\r
-                const A12& v12, const A13& v13, const A14& v14, const A15& v15,\r
-                const A16& v16, const A17& v17)\r
-    {\r
-        Fmt(szFmt, FmtArg<A1>(v1).Val(), FmtArg<A2>(v2).Val(),\r
-            FmtArg<A3>(v3).Val(), FmtArg<A4>(v4).Val(), FmtArg<A5>(v5).Val(),\r
-            FmtArg<A6>(v6).Val(), FmtArg<A7>(v7).Val(), FmtArg<A8>(v8).Val(),\r
-            FmtArg<A9>(v9).Val(), FmtArg<A10>(v10).Val(),FmtArg<A11>(v11).Val(),\r
-            FmtArg<A12>(v12).Val(),FmtArg<A13>(v13).Val(),FmtArg<A14>(v14).Val(),\r
-            FmtArg<A15>(v15).Val(),FmtArg<A16>(v16).Val(),FmtArg<A17>(v17).Val());\r
-    }\r
-\r
-#else  // #ifdef SS_SAFE_FORMAT\r
-\r
-\r
-#ifndef SS_ANSI\r
-\r
-       void Format(UINT nId, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, nId);\r
-               va_start(argList, nId);\r
-\r
-               MYTYPE strFmt;\r
-               if ( strFmt.Load(nId) )\r
-                       FormatV(strFmt, argList);\r
-\r
-               va_end(argList);\r
-       }\r
-    \r
-#endif  // #ifdef SS_ANSI\r
-\r
-       void Format(const CT* szFmt, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, szFmt);\r
-               FormatV(szFmt, argList);\r
-               va_end(argList);\r
-       }\r
-\r
-#endif // #ifdef SS_SAFE_FORMAT\r
-\r
-       void AppendFormat(const CT* szFmt, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, szFmt);\r
-               AppendFormatV(szFmt, argList);\r
-               va_end(argList);\r
-       }\r
-\r
-       #define MAX_FMT_TRIES           5        // #of times we try \r
-       #define FMT_BLOCK_SIZE          2048 // # of bytes to increment per try\r
-       #define BUFSIZE_1ST     256\r
-       #define BUFSIZE_2ND 512\r
-       #define STD_BUF_SIZE            1024\r
-\r
-       // an efficient way to add formatted characters to the string.  You may only\r
-       // add up to STD_BUF_SIZE characters at a time, though\r
-       void AppendFormatV(const CT* szFmt, va_list argList)\r
-       {\r
-               CT szBuf[STD_BUF_SIZE];\r
-       #if defined(SS_ANSI) || !defined(_MSC_VER)\r
-               int nLen = ssvsprintf(szBuf, STD_BUF_SIZE-1, szFmt, argList);\r
-       #else\r
-               int nLen = ssnprintf(szBuf, STD_BUF_SIZE-1, szFmt, argList);\r
-       #endif\r
-               if ( 0 < nLen )\r
-                       this->append(szBuf, nLen);\r
-       }\r
-\r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION:  FormatV\r
-       //              void FormatV(PCSTR szFormat, va_list, argList);\r
-       //           \r
-       // DESCRIPTION:\r
-       //              This function formats the string with sprintf style format-specs. \r
-       //              It makes a general guess at required buffer size and then tries\r
-       //              successively larger buffers until it finds one big enough or a\r
-       //              threshold (MAX_FMT_TRIES) is exceeded.\r
-       //\r
-       // PARAMETERS:\r
-       //              szFormat - a PCSTR holding the format of the output\r
-       //              argList - a Microsoft specific va_list for variable argument lists\r
-       //\r
-       // RETURN VALUE:\r
-       // -------------------------------------------------------------------------\r
-\r
-       void FormatV(const CT* szFormat, va_list argList)\r
-       {\r
-       #if defined(SS_ANSI) || !defined(_MSC_VER)\r
-               int nLen        = sslen(szFormat) + STD_BUF_SIZE;\r
-               ssvsprintf(GetBuffer(nLen), nLen-1, szFormat, argList);\r
-               ReleaseBuffer();\r
-\r
-       #else\r
-\r
-               CT* pBuf                        = NULL;\r
-               int nChars                      = 1;\r
-               int nUsed                       = 0;\r
-               size_type nActual       = 0;\r
-               int nTry                        = 0;\r
-\r
-               do\r
-               {\r
-                       // Grow more than linearly (e.g. 512, 1536, 3072, etc)\r
-\r
-                       nChars                  += ((nTry+1) * FMT_BLOCK_SIZE);\r
-                       pBuf                    = reinterpret_cast<CT*>(_alloca(sizeof(CT)*nChars));\r
-                       nUsed                   = ssnprintf(pBuf, nChars-1, szFormat, argList);\r
-\r
-                       // Ensure proper NULL termination.\r
-\r
-                       nActual                 = nUsed == -1 ? nChars-1 : SSMIN(nUsed, nChars-1);\r
-                       pBuf[nActual+1]= '\0';\r
-\r
-\r
-               } while ( nUsed < 0 && nTry++ < MAX_FMT_TRIES );\r
-\r
-               // assign whatever we managed to format\r
-\r
-               this->assign(pBuf, nActual);\r
-\r
-       #endif\r
-       }\r
-       \r
-\r
-       // -------------------------------------------------------------------------\r
-       // CString Facade Functions:\r
-       //\r
-       // The following methods are intended to allow you to use this class as a\r
-       // drop-in replacement for CString.\r
-       // -------------------------------------------------------------------------\r
-       #ifdef SS_WIN32\r
-               BSTR AllocSysString() const\r
-               {\r
-                       ostring os;\r
-                       ssasn(os, *this);\r
-                       return ::SysAllocString(os.c_str());\r
-               }\r
-       #endif\r
-\r
-       int Collate(PCMYSTR szThat) const\r
-       {\r
-               return sscoll(this->c_str(), this->length(), szThat, sslen(szThat));\r
-       }\r
-\r
-       int CollateNoCase(PCMYSTR szThat) const\r
-       {\r
-               return ssicoll(this->c_str(), this->length(), szThat, sslen(szThat));\r
-       }\r
-\r
-       int Compare(PCMYSTR szThat) const\r
-       {\r
-               return this->compare(szThat);   \r
-       }\r
-\r
-       int CompareNoCase(PCMYSTR szThat)       const\r
-       {\r
-               return ssicmp(this->c_str(), szThat);\r
-       }\r
-\r
-       int Delete(int nIdx, int nCount=1)\r
-       {\r
-        if ( nIdx < 0 )\r
-                       nIdx = 0;\r
-\r
-               if ( nIdx < GetLength() )\r
-                       this->erase(static_cast<MYSIZE>(nIdx), static_cast<MYSIZE>(nCount));\r
-\r
-               return GetLength();\r
-       }\r
-\r
-       void Empty()\r
-       {\r
-               this->erase();\r
-       }\r
-\r
-       int Find(CT ch) const\r
-       {\r
-               MYSIZE nIdx     = this->find_first_of(ch);\r
-               return static_cast<int>(MYBASE::npos == nIdx  ? -1 : nIdx);\r
-       }\r
-\r
-       int Find(PCMYSTR szSub) const\r
-       {\r
-               MYSIZE nIdx     = this->find(szSub);\r
-               return static_cast<int>(MYBASE::npos == nIdx ? -1 : nIdx);\r
-       }\r
-\r
-       int Find(CT ch, int nStart) const\r
-       {\r
-               // CString::Find docs say add 1 to nStart when it's not zero\r
-               // CString::Find code doesn't do that however.  We'll stick\r
-               // with what the code does\r
-\r
-               MYSIZE nIdx     = this->find_first_of(ch, static_cast<MYSIZE>(nStart));\r
-               return static_cast<int>(MYBASE::npos == nIdx ? -1 : nIdx);\r
-       }\r
-\r
-       int Find(PCMYSTR szSub, int nStart) const\r
-       {\r
-               // CString::Find docs say add 1 to nStart when it's not zero\r
-               // CString::Find code doesn't do that however.  We'll stick\r
-               // with what the code does\r
-\r
-               MYSIZE nIdx     = this->find(szSub, static_cast<MYSIZE>(nStart));\r
-               return static_cast<int>(MYBASE::npos == nIdx ? -1 : nIdx);\r
-       }\r
-\r
-       int FindOneOf(PCMYSTR szCharSet) const\r
-       {\r
-               MYSIZE nIdx = this->find_first_of(szCharSet);\r
-               return static_cast<int>(MYBASE::npos == nIdx ? -1 : nIdx);\r
-       }\r
-\r
-#ifndef SS_ANSI\r
-       void FormatMessage(PCMYSTR szFormat, ...) throw(std::exception)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, szFormat);\r
-               PMYSTR szTemp;\r
-               if ( ssfmtmsg(FORMAT_MESSAGE_FROM_STRING|FORMAT_MESSAGE_ALLOCATE_BUFFER,\r
-                                          szFormat, 0, 0,\r
-                                          reinterpret_cast<PMYSTR>(&szTemp), 0, &argList) == 0 ||\r
-                        szTemp == 0 )\r
-               {\r
-                       throw std::runtime_error("out of memory");\r
-               }\r
-               *this = szTemp;\r
-               LocalFree(szTemp);\r
-               va_end(argList);\r
-       }\r
-\r
-       void FormatMessage(UINT nFormatId, ...) throw(std::exception)\r
-       {\r
-               MYTYPE sFormat;\r
-               VERIFY(sFormat.LoadString(nFormatId) != 0);\r
-               va_list argList;\r
-               va_start(argList, nFormatId);\r
-               PMYSTR szTemp;\r
-               if ( ssfmtmsg(FORMAT_MESSAGE_FROM_STRING|FORMAT_MESSAGE_ALLOCATE_BUFFER,\r
-                                          sFormat, 0, 0,\r
-                                          reinterpret_cast<PMYSTR>(&szTemp), 0, &argList) == 0 ||\r
-                       szTemp == 0)\r
-               {\r
-                       throw std::runtime_error("out of memory");\r
-               }\r
-               *this = szTemp;\r
-               LocalFree(szTemp);\r
-               va_end(argList);\r
-       }\r
-#endif\r
-\r
-\r
-       // -------------------------------------------------------------------------\r
-       // GetXXXX -- Direct access to character buffer\r
-       // -------------------------------------------------------------------------\r
-       CT GetAt(int nIdx) const\r
-       {\r
-               return this->at(static_cast<MYSIZE>(nIdx));\r
-       }\r
-\r
-       CT* GetBuffer(int nMinLen=-1)\r
-       {\r
-               return GetBuf(nMinLen);\r
-       }\r
-\r
-       CT* GetBufferSetLength(int nLen)\r
-       {\r
-               return BufferSet(nLen);\r
-       }\r
-\r
-       // GetLength() -- MFC docs say this is the # of BYTES but\r
-       // in truth it is the number of CHARACTERs (chars or wchar_ts)\r
-       int GetLength() const\r
-       {\r
-               return static_cast<int>(this->length());\r
-       }\r
-\r
-       \r
-       int Insert(int nIdx, CT ch)\r
-       {\r
-               if ( static_cast<MYSIZE>(nIdx) > this->size() -1 )\r
-                       this->append(1, ch);\r
-               else\r
-                       this->insert(static_cast<MYSIZE>(nIdx), 1, ch);\r
-\r
-               return GetLength();\r
-       }\r
-       int Insert(int nIdx, PCMYSTR sz)\r
-       {\r
-               if ( nIdx >= this->size() )\r
-                       this->append(sz, sslen(sz));\r
-               else\r
-                       this->insert(static_cast<MYSIZE>(nIdx), sz);\r
-\r
-               return GetLength();\r
-       }\r
-\r
-       bool IsEmpty() const\r
-       {\r
-               return this->empty();\r
-       }\r
-\r
-       MYTYPE Left(int nCount) const\r
-       {\r
-        // Range check the count.\r
-\r
-               nCount = SSMAX(0, SSMIN(nCount, static_cast<int>(this->size())));\r
-               return this->substr(0, static_cast<MYSIZE>(nCount)); \r
-       }\r
-\r
-#ifndef SS_ANSI\r
-       bool LoadString(UINT nId)\r
-       {\r
-               return this->Load(nId);\r
-       }\r
-#endif\r
-\r
-       void MakeLower()\r
-       {\r
-               ToLower();\r
-       }\r
-\r
-       void MakeReverse()\r
-       {\r
-               std::reverse(this->begin(), this->end());\r
-       }\r
-\r
-       void MakeUpper()\r
-       { \r
-               ToUpper();\r
-       }\r
-\r
-       MYTYPE Mid(int nFirst ) const\r
-       {\r
-               return Mid(nFirst, size()-nFirst);\r
-       }\r
-\r
-       MYTYPE Mid(int nFirst, int nCount) const\r
-       {\r
-               // CString does range checking here.  Since we're trying to emulate it,\r
-               // we must check too.\r
-\r
-               if ( nFirst < 0 )\r
-                       nFirst = 0;\r
-               if ( nCount < 0 )\r
-                       nCount = 0;\r
-\r
-               if ( nFirst + nCount > size() )\r
-                       nCount = size() - nFirst;\r
-\r
-               if ( nFirst > size() )\r
-                       return MYTYPE();\r
-\r
-               ASSERT(nFirst >= 0);\r
-               ASSERT(nFirst + nCount <= size());\r
-\r
-               return this->substr(static_cast<MYSIZE>(nFirst),\r
-                                                       static_cast<MYSIZE>(nCount));\r
-       }\r
-\r
-       void ReleaseBuffer(int nNewLen=-1)\r
-       {\r
-               RelBuf(nNewLen);\r
-       }\r
-\r
-       int Remove(CT ch)\r
-       {\r
-               MYSIZE nIdx             = 0;\r
-               int nRemoved    = 0;\r
-               while ( (nIdx=this->find_first_of(ch)) != MYBASE::npos )\r
-               {\r
-                       this->erase(nIdx, 1);\r
-                       nRemoved++;\r
-               }\r
-               return nRemoved;\r
-       }\r
-\r
-       int Replace(CT chOld, CT chNew)\r
-       {\r
-               int nReplaced   = 0;\r
-               for ( MYITER iter=this->begin(); iter != this->end(); iter++ )\r
-               {\r
-                       if ( *iter == chOld )\r
-                       {\r
-                               *iter = chNew;\r
-                               nReplaced++;\r
-                       }\r
-               }\r
-               return nReplaced;\r
-       }\r
-\r
-       int Replace(PCMYSTR szOld, PCMYSTR szNew)\r
-       {\r
-               int nReplaced           = 0;\r
-               MYSIZE nIdx                     = 0;\r
-               MYSIZE nOldLen          = sslen(szOld);\r
-               if ( 0 == nOldLen )\r
-                       return 0;\r
-\r
-               static const CT ch      = CT(0);\r
-               MYSIZE nNewLen          = sslen(szNew);\r
-               PCMYSTR szRealNew       = szNew == 0 ? &ch : szNew;\r
-\r
-               while ( (nIdx=this->find(szOld, nIdx)) != MYBASE::npos )\r
-               {\r
-                       replace(this->begin()+nIdx, this->begin()+nIdx+nOldLen, szRealNew);\r
-                       nReplaced++;\r
-                       nIdx += nNewLen;\r
-               }\r
-               return nReplaced;\r
-       }\r
-\r
-       int ReverseFind(CT ch) const\r
-       {\r
-               MYSIZE nIdx     = this->find_last_of(ch);\r
-               return static_cast<int>(MYBASE::npos == nIdx ? -1 : nIdx);\r
-       }\r
-\r
-       // ReverseFind overload that's not in CString but might be useful\r
-       int ReverseFind(PCMYSTR szFind, MYSIZE pos=MYBASE::npos) const\r
-       {\r
-               MYSIZE nIdx     = this->rfind(0 == szFind ? MYTYPE() : szFind, pos);\r
-               return static_cast<int>(MYBASE::npos == nIdx ? -1 : nIdx);\r
-       }\r
-\r
-       MYTYPE Right(int nCount) const\r
-       {\r
-        // Range check the count.\r
-\r
-               nCount = SSMAX(0, SSMIN(nCount, static_cast<int>(this->size())));\r
-               return this->substr(this->size()-static_cast<MYSIZE>(nCount));\r
-       }\r
-\r
-       void SetAt(int nIndex, CT ch)\r
-       {\r
-               ASSERT(this->size() > static_cast<MYSIZE>(nIndex));\r
-               this->at(static_cast<MYSIZE>(nIndex))           = ch;\r
-       }\r
-\r
-#ifndef SS_ANSI\r
-       BSTR SetSysString(BSTR* pbstr) const\r
-       {\r
-               ostring os;\r
-               ssasn(os, *this);\r
-               if ( !::SysReAllocStringLen(pbstr, os.c_str(), os.length()) )\r
-                       throw std::runtime_error("out of memory");\r
-\r
-               ASSERT(*pbstr != 0);\r
-               return *pbstr;\r
-       }\r
-#endif\r
-\r
-       MYTYPE SpanExcluding(PCMYSTR szCharSet) const\r
-       {\r
-        MYSIZE pos = this->find_first_of(szCharSet);\r
-        return pos == MYBASE::npos ? *this : Left(pos);\r
-       }\r
-\r
-       MYTYPE SpanIncluding(PCMYSTR szCharSet) const\r
-       {\r
-        MYSIZE pos = this->find_first_not_of(szCharSet);\r
-        return pos == MYBASE::npos ? *this : Left(pos);\r
-       }\r
-\r
-#if !defined(UNICODE) && !defined(SS_ANSI)\r
-\r
-       // CString's OemToAnsi and AnsiToOem functions are available only in\r
-       // Unicode builds.  However since we're a template we also need a\r
-       // runtime check of CT and a reinterpret_cast to account for the fact\r
-       // that CStdStringW gets instantiated even in non-Unicode builds.\r
-\r
-       void AnsiToOem()\r
-       {\r
-               if ( sizeof(CT) == sizeof(char) && !empty() )\r
-               {\r
-                       ::CharToOem(reinterpret_cast<PCSTR>(this->c_str()),\r
-                                               reinterpret_cast<PSTR>(GetBuf()));\r
-               }\r
-               else\r
-               {\r
-                       ASSERT(false);\r
-               }\r
-       }\r
-\r
-       void OemToAnsi()\r
-       {\r
-               if ( sizeof(CT) == sizeof(char) && !empty() )\r
-               {\r
-                       ::OemToChar(reinterpret_cast<PCSTR>(this->c_str()),\r
-                                               reinterpret_cast<PSTR>(GetBuf()));\r
-               }\r
-               else\r
-               {\r
-                       ASSERT(false);\r
-               }\r
-       }\r
-\r
-#endif\r
-       \r
-\r
-       // -------------------------------------------------------------------------\r
-       // Trim and its variants\r
-       // -------------------------------------------------------------------------\r
-       MYTYPE& Trim()\r
-       {\r
-               return TrimLeft().TrimRight();\r
-       }\r
-\r
-       MYTYPE& TrimLeft()\r
-       {\r
-               this->erase(this->begin(),\r
-                       std::find_if(this->begin(), this->end(), NotSpace<CT>()));\r
-\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE&  TrimLeft(CT tTrim)\r
-       {\r
-               this->erase(0, this->find_first_not_of(tTrim));\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE&  TrimLeft(PCMYSTR szTrimChars)\r
-       {\r
-               this->erase(0, this->find_first_not_of(szTrimChars));\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE& TrimRight()\r
-       {\r
-               // NOTE:  When comparing reverse_iterators here (MYRITER), I avoid using\r
-               // operator!=.  This is because namespace rel_ops also has a template\r
-               // operator!= which conflicts with the global operator!= already defined\r
-               // for reverse_iterator in the header <utility>.\r
-               // Thanks to John James for alerting me to this.\r
-\r
-               MYRITER it = std::find_if(this->rbegin(), this->rend(), NotSpace<CT>());\r
-               if ( !(this->rend() == it) )\r
-                       this->erase(this->rend() - it);\r
-\r
-               this->erase(!(it == this->rend()) ? this->find_last_of(*it) + 1 : 0);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE&  TrimRight(CT tTrim)\r
-       {\r
-               MYSIZE nIdx     = this->find_last_not_of(tTrim);\r
-               this->erase(MYBASE::npos == nIdx ? 0 : ++nIdx);\r
-               return *this;\r
-       }\r
-\r
-       MYTYPE&  TrimRight(PCMYSTR szTrimChars)\r
-       {\r
-               MYSIZE nIdx     = this->find_last_not_of(szTrimChars);\r
-               this->erase(MYBASE::npos == nIdx ? 0 : ++nIdx);\r
-               return *this;\r
-       }\r
-\r
-       void                    FreeExtra()\r
-       {\r
-               MYTYPE mt;\r
-               this->swap(mt);\r
-               if ( !mt.empty() )\r
-                       this->assign(mt.c_str(), mt.size());\r
-       }\r
-\r
-       // I have intentionally not implemented the following CString\r
-       // functions.   You cannot make them work without taking advantage\r
-       // of implementation specific behavior.  However if you absolutely\r
-       // MUST have them, uncomment out these lines for "sort-of-like"\r
-       // their behavior.  You're on your own.\r
-\r
-//     CT*                             LockBuffer()    { return GetBuf(); }// won't really lock\r
-//     void                    UnlockBuffer(); { }     // why have UnlockBuffer w/o LockBuffer?\r
-\r
-       // Array-indexing operators.  Required because we defined an implicit cast\r
-       // to operator const CT* (Thanks to Julian Selman for pointing this out)\r
-       CT& operator[](int nIdx)\r
-       {\r
-               return MYBASE::operator[](static_cast<MYSIZE>(nIdx));\r
-       }\r
-\r
-       const CT& operator[](int nIdx) const\r
-       {\r
-               return MYBASE::operator[](static_cast<MYSIZE>(nIdx));\r
-       }\r
-\r
-       CT& operator[](unsigned int nIdx)\r
-       {\r
-               return MYBASE::operator[](static_cast<MYSIZE>(nIdx));\r
-       }\r
-\r
-       const CT& operator[](unsigned int nIdx) const\r
-       {\r
-               return MYBASE::operator[](static_cast<MYSIZE>(nIdx));\r
-       }\r
-\r
-#ifndef SS_NO_IMPLICIT_CAST\r
-       operator const CT*() const\r
-       {\r
-               return this->c_str();\r
-       }\r
-#endif\r
-\r
-       // IStream related functions.  Useful in IPersistStream implementations\r
-\r
-#ifdef SS_INC_COMDEF\r
-\r
-       // struct SSSHDR - useful for non Std C++ persistence schemes.\r
-       typedef struct SSSHDR\r
-       {\r
-               BYTE    byCtrl;\r
-               ULONG   nChars;\r
-       } SSSHDR;       // as in "Standard String Stream Header"\r
-\r
-       #define SSSO_UNICODE    0x01    // the string is a wide string\r
-       #define SSSO_COMPRESS   0x02    // the string is compressed\r
-\r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION: StreamSize\r
-       // REMARKS:\r
-       //              Returns how many bytes it will take to StreamSave() this CStdString\r
-       //              object to an IStream.\r
-       // -------------------------------------------------------------------------\r
-       ULONG StreamSize() const\r
-       {\r
-               // Control header plus string\r
-               ASSERT(this->size()*sizeof(CT) < 0xffffffffUL - sizeof(SSSHDR));\r
-               return (this->size() * sizeof(CT)) + sizeof(SSSHDR);\r
-       }\r
-\r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION: StreamSave\r
-       // REMARKS:\r
-       //              Saves this CStdString object to a COM IStream.\r
-       // -------------------------------------------------------------------------\r
-       HRESULT StreamSave(IStream* pStream) const\r
-       {\r
-               ASSERT(size()*sizeof(CT) < 0xffffffffUL - sizeof(SSSHDR));\r
-               HRESULT hr              = E_FAIL;\r
-               ASSERT(pStream != 0);\r
-               SSSHDR hdr;\r
-               hdr.byCtrl              = sizeof(CT) == 2 ? SSSO_UNICODE : 0;\r
-               hdr.nChars              = this->size();\r
-\r
-\r
-               if ( FAILED(hr=pStream->Write(&hdr, sizeof(SSSHDR), 0)) )\r
-                       TRACE(_T("StreamSave: Cannot write control header, ERR=0x%X\n"),hr);\r
-               else if ( empty() )\r
-                       ;               // nothing to write\r
-               else if ( FAILED(hr=pStream->Write(this->c_str(), this->size()*sizeof(CT), 0)) )\r
-                       TRACE(_T("StreamSave: Cannot write string to stream 0x%X\n"), hr);\r
-\r
-               return hr;\r
-       }\r
-\r
-\r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION: StreamLoad\r
-       // REMARKS:\r
-       //              This method loads the object from an IStream.\r
-       // -------------------------------------------------------------------------\r
-       HRESULT StreamLoad(IStream* pStream)\r
-       {\r
-               ASSERT(pStream != 0);\r
-               SSSHDR hdr;\r
-               HRESULT hr                      = E_FAIL;\r
-\r
-               if ( FAILED(hr=pStream->Read(&hdr, sizeof(SSSHDR), 0)) )\r
-               {\r
-                       TRACE(_T("StreamLoad: Cant read control header, ERR=0x%X\n"), hr);\r
-               }\r
-               else if ( hdr.nChars > 0 )\r
-               {\r
-                       ULONG nRead             = 0;\r
-                       PMYSTR pMyBuf   = BufferSet(hdr.nChars);\r
-\r
-                       // If our character size matches the character size of the string\r
-                       // we're trying to read, then we can read it directly into our\r
-                       // buffer. Otherwise, we have to read into an intermediate buffer\r
-                       // and convert.\r
-                       \r
-                       if ( (hdr.byCtrl & SSSO_UNICODE) != 0 )\r
-                       {\r
-                               ULONG nBytes    = hdr.nChars * sizeof(wchar_t);\r
-                               if ( sizeof(CT) == sizeof(wchar_t) )\r
-                               {\r
-                                       if ( FAILED(hr=pStream->Read(pMyBuf, nBytes, &nRead)) )\r
-                                               TRACE(_T("StreamLoad: Cannot read string: 0x%X\n"), hr);\r
-                               }\r
-                               else\r
-                               {       \r
-                                       PWSTR pBufW = reinterpret_cast<PWSTR>(_alloca((nBytes)+1));\r
-                                       if ( FAILED(hr=pStream->Read(pBufW, nBytes, &nRead)) )\r
-                                               TRACE(_T("StreamLoad: Cannot read string: 0x%X\n"), hr);\r
-                                       else\r
-                                               sscpy(pMyBuf, pBufW, hdr.nChars);\r
-                               }\r
-                       }\r
-                       else\r
-                       {\r
-                               ULONG nBytes    = hdr.nChars * sizeof(char);\r
-                               if ( sizeof(CT) == sizeof(char) )\r
-                               {\r
-                                       if ( FAILED(hr=pStream->Read(pMyBuf, nBytes, &nRead)) )\r
-                                               TRACE(_T("StreamLoad: Cannot read string: 0x%X\n"), hr);\r
-                               }\r
-                               else\r
-                               {\r
-                                       PSTR pBufA = reinterpret_cast<PSTR>(_alloca(nBytes));\r
-                                       if ( FAILED(hr=pStream->Read(pBufA, hdr.nChars, &nRead)) )\r
-                                               TRACE(_T("StreamLoad: Cannot read string: 0x%X\n"), hr);\r
-                                       else\r
-                                               sscpy(pMyBuf, pBufA, hdr.nChars);\r
-                               }\r
-                       }\r
-               }\r
-               else\r
-               {\r
-                       this->erase();\r
-               }\r
-               return hr;\r
-       }\r
-#endif // #ifdef SS_INC_COMDEF\r
-\r
-#ifndef SS_ANSI\r
-\r
-       // SetResourceHandle/GetResourceHandle.  In MFC builds, these map directly\r
-       // to AfxSetResourceHandle and AfxGetResourceHandle.  In non-MFC builds they\r
-       // point to a single static HINST so that those who call the member\r
-       // functions that take resource IDs can provide an alternate HINST of a DLL\r
-       // to search.  This is not exactly the list of HMODULES that MFC provides\r
-       // but it's better than nothing.\r
-\r
-#ifdef _MFC_VER\r
-       static void SetResourceHandle(HMODULE hNew)\r
-       {\r
-               AfxSetResourceHandle(hNew);\r
-       }\r
-       static HMODULE GetResourceHandle()\r
-       {\r
-               return AfxGetResourceHandle();\r
-       }\r
-#else\r
-       static void SetResourceHandle(HMODULE hNew)\r
-       {\r
-               SSResourceHandle() = hNew;\r
-       }\r
-       static HMODULE GetResourceHandle()\r
-       {\r
-               return SSResourceHandle();\r
-       }\r
-#endif\r
-\r
-\r
-    template<typename CT2>\r
-    MYTYPE operator+(const CStdStr<CT2>& s2)\r
-    {\r
-           MYTYPE strRet(SSREF(*this));\r
-        strRet += s2.c_str();\r
-           return strRet;\r
-    }\r
-\r
-\r
-#endif\r
-};\r
-\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// CStdStr friend addition functions defined as inline\r
-// -----------------------------------------------------------------------------\r
-template<typename CT>\r
-inline\r
-CStdStr<CT> operator+(const  CStdStr<CT>& str1, const CStdStr<CT>& str2)\r
-{\r
-       CStdStr<CT> strRet(SSREF(str1));\r
-       strRet.append(str2);\r
-       return strRet;\r
-}\r
-\r
-template<typename CT>  \r
-inline\r
-CStdStr<CT> operator+(const  CStdStr<CT>& str, CT t)\r
-{\r
-       // this particular overload is needed for disabling reference counting\r
-       // though it's only an issue from line 1 to line 2\r
-\r
-       CStdStr<CT> strRet(SSREF(str)); // 1\r
-       strRet.append(1, t);                            // 2\r
-       return strRet;\r
-}\r
-\r
-template<typename CT>\r
-inline\r
-CStdStr<CT> operator+(const  CStdStr<CT>& str, PCSTR pA)\r
-{\r
-       return CStdStr<CT>(str) + CStdStr<CT>(pA);\r
-}\r
-\r
-template<typename CT>\r
-inline\r
-CStdStr<CT> operator+(PCSTR pA, const CStdStr<CT>& str)\r
-{\r
-       CStdStr<CT> strRet(pA);\r
-       strRet.append(str);\r
-       return strRet;\r
-}\r
-\r
-template<typename CT>\r
-inline\r
-CStdStr<CT> operator+(const CStdStr<CT>& str, PCWSTR pW)\r
-{ \r
-       return CStdStr<CT>(SSREF(str)) + CStdStr<CT>(pW);\r
-}\r
-\r
-template<typename CT>\r
-inline\r
-CStdStr<CT> operator+(PCWSTR pW, const CStdStr<CT>& str)\r
-{\r
-       CStdStr<CT> strRet(pW);\r
-       strRet.append(str);\r
-       return strRet;\r
-}\r
-\r
-#ifdef SS_INC_COMDEF\r
-       template<typename CT>\r
-       inline\r
-       CStdStr<CT> operator+(const _bstr_t& bstr, const CStdStr<CT>& str)\r
-       {\r
-               return static_cast<const CT*>(bstr) + str;\r
-       }\r
-\r
-       template<typename CT>\r
-       inline\r
-       CStdStr<CT> operator+(const CStdStr<CT>& str, const _bstr_t& bstr)\r
-       {\r
-               return str + static_cast<const CT*>(bstr);\r
-       }\r
-#endif\r
-\r
-// -----------------------------------------------------------------------------\r
-// HOW TO EXPORT CSTDSTRING FROM A DLL\r
-//\r
-// If you want to export CStdStringA and CStdStringW from a DLL, then all you\r
-// need to\r
-//             1.      make sure that all components link to the same DLL version\r
-//                     of the CRT (not the static one).\r
-//             2.      Uncomment the 3 lines of code below\r
-//             3.      #define 2 macros per the instructions in MS KnowledgeBase\r
-//                     article Q168958.  The macros are:\r
-//\r
-//             MACRO           DEFINTION WHEN EXPORTING                DEFINITION WHEN IMPORTING\r
-//             -----           ------------------------                -------------------------\r
-//             SSDLLEXP        (nothing, just #define it)              extern\r
-//             SSDLLSPEC       __declspec(dllexport)                   __declspec(dllimport)\r
-//\r
-//             Note that these macros must be available to ALL clients who want to \r
-//             link to the DLL and use the class.  If they \r
-// -----------------------------------------------------------------------------\r
-//#pragma warning(disable:4231) // non-standard extension ("extern template")\r
-//     SSDLLEXP template class SSDLLSPEC CStdStr<char>;\r
-//     SSDLLEXP template class SSDLLSPEC CStdStr<wchar_t>;\r
-\r
-// =============================================================================\r
-//                                             END OF CStdStr INLINE FUNCTION DEFINITIONS\r
-// =============================================================================\r
-\r
-//     Now typedef our class names based upon this humongous template\r
-\r
-typedef CStdStr<char>          CStdStringA;    // a better std::string\r
-typedef CStdStr<wchar_t>       CStdStringW;    // a better std::wstring\r
-typedef CStdStr<OLECHAR>       CStdStringO;    // almost always CStdStringW\r
-\r
-\r
-// New-style format function is a template\r
-\r
-#ifdef SS_SAFE_FORMAT\r
-\r
-template<>\r
-struct FmtArg<CStdStringA>\r
-{\r
-    explicit FmtArg(const CStdStringA& arg) : a_(arg) {}\r
-    PCSTR Val() const { return a_.c_str(); }\r
-    const CStdStringA& a_;\r
-private:\r
-    FmtArg<CStdStringA>& operator=(const FmtArg<CStdStringA>&) { return *this; }\r
-};\r
-template<>\r
-struct FmtArg<CStdStringW>\r
-{\r
-    explicit FmtArg(const CStdStringW& arg) : a_(arg) {}\r
-    PCWSTR Val() const { return a_.c_str(); }\r
-    const CStdStringW& a_;\r
-private:\r
-    FmtArg<CStdStringW>& operator=(const FmtArg<CStdStringW>&) { return *this; }\r
-};\r
-\r
-template<>\r
-struct FmtArg<std::string>\r
-{\r
-    explicit FmtArg(const std::string& arg) : a_(arg) {}\r
-    PCSTR Val() const { return a_.c_str(); }\r
-    const std::string& a_;\r
-private:\r
-    FmtArg<std::string>& operator=(const FmtArg<std::string>&) { return *this; }\r
-};\r
-template<>\r
-struct FmtArg<std::wstring>\r
-{\r
-    explicit FmtArg(const std::wstring& arg) : a_(arg) {}\r
-    PCWSTR Val() const { return a_.c_str(); }\r
-    const std::wstring& a_;\r
-private:\r
-    FmtArg<std::wstring>& operator=(const FmtArg<std::wstring>&) {return *this;}\r
-};\r
-#endif // #ifdef SS_SAFEFORMAT\r
-\r
-#ifndef SS_ANSI\r
-       // SSResourceHandle: our MFC-like resource handle\r
-       inline HMODULE& SSResourceHandle()\r
-       {\r
-               static HMODULE hModuleSS        = GetModuleHandle(0);\r
-               return hModuleSS;\r
-       }\r
-#endif\r
-\r
-\r
-\r
-\r
-// In MFC builds, define some global serialization operators\r
-// Special operators that allow us to serialize CStdStrings to CArchives.\r
-// Note that we use an intermediate CString object in order to ensure that\r
-// we use the exact same format.\r
-\r
-#ifdef _MFC_VER\r
-       inline CArchive& AFXAPI operator<<(CArchive& ar, const CStdStringA& strA)\r
-       {\r
-               CString strTemp = strA;\r
-               return ar << strTemp;\r
-       }\r
-       inline CArchive& AFXAPI operator<<(CArchive& ar, const CStdStringW& strW)\r
-       {\r
-               CString strTemp = strW;\r
-               return ar << strTemp;\r
-       }\r
-\r
-       inline CArchive& AFXAPI operator>>(CArchive& ar, CStdStringA& strA)\r
-       {\r
-               CString strTemp;\r
-               ar >> strTemp;\r
-               strA = strTemp;\r
-               return ar;\r
-       }\r
-       inline CArchive& AFXAPI operator>>(CArchive& ar, CStdStringW& strW)\r
-       {\r
-               CString strTemp;\r
-               ar >> strTemp;\r
-               strW = strTemp;\r
-               return ar;\r
-       }\r
-#endif // #ifdef _MFC_VER -- (i.e. is this MFC?)\r
-\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// GLOBAL FUNCTION:  WUFormat\r
-//             CStdStringA WUFormat(UINT nId, ...);\r
-//             CStdStringA WUFormat(PCSTR szFormat, ...);\r
-//\r
-// REMARKS:\r
-//             This function allows the caller for format and return a CStdStringA\r
-//             object with a single line of code.\r
-// -----------------------------------------------------------------------------\r
-#ifdef SS_ANSI\r
-#else\r
-\r
-       inline CStdStringA WUFormatA(UINT nId, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, nId);\r
-\r
-               CStdStringA strFmt;\r
-               CStdStringA strOut;\r
-               if ( strFmt.Load(nId) )\r
-                       strOut.FormatV(strFmt, argList);\r
-\r
-               va_end(argList);\r
-               return strOut;\r
-       }\r
-       inline CStdStringA WUFormatA(PCSTR szFormat, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, szFormat);\r
-               CStdStringA strOut;\r
-               strOut.FormatV(szFormat, argList);\r
-               va_end(argList);\r
-               return strOut;\r
-       }\r
-\r
-       inline CStdStringW WUFormatW(UINT nId, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, nId);\r
-\r
-               CStdStringW strFmt;\r
-               CStdStringW strOut;\r
-               if ( strFmt.Load(nId) )\r
-                       strOut.FormatV(strFmt, argList);\r
-\r
-               va_end(argList);\r
-               return strOut;\r
-       }\r
-       inline CStdStringW WUFormatW(PCWSTR szwFormat, ...)\r
-       {\r
-               va_list argList;\r
-               va_start(argList, szwFormat);\r
-               CStdStringW strOut;\r
-               strOut.FormatV(szwFormat, argList);\r
-               va_end(argList);\r
-               return strOut;\r
-       }\r
-#endif // #ifdef SS_ANSI\r
-\r
-#ifdef SS_WIN32\r
-       // -------------------------------------------------------------------------\r
-       // FUNCTION: WUSysMessage\r
-       //       CStdStringA WUSysMessageA(DWORD dwError, DWORD dwLangId=SS_DEFLANGID);\r
-       //       CStdStringW WUSysMessageW(DWORD dwError, DWORD dwLangId=SS_DEFLANGID);\r
-       //           \r
-       // DESCRIPTION:\r
-       //       This function simplifies the process of obtaining a string equivalent\r
-       //       of a system error code returned from GetLastError().  You simply\r
-       //       supply the value returned by GetLastError() to this function and the\r
-       //       corresponding system string is returned in the form of a CStdStringA.\r
-       //\r
-       // PARAMETERS: \r
-       //       dwError - a DWORD value representing the error code to be translated\r
-       //       dwLangId - the language id to use.  defaults to english.\r
-       //\r
-       // RETURN VALUE: \r
-       //       a CStdStringA equivalent of the error code.  Currently, this function\r
-       //       only returns either English of the system default language strings.  \r
-       // -------------------------------------------------------------------------\r
-       #define SS_DEFLANGID MAKELANGID(LANG_NEUTRAL,SUBLANG_DEFAULT)\r
-       inline CStdStringA WUSysMessageA(DWORD dwError, DWORD dwLangId=SS_DEFLANGID)\r
-       {\r
-               CHAR szBuf[512];\r
-\r
-               if ( 0 != ::FormatMessageA(FORMAT_MESSAGE_FROM_SYSTEM, NULL, dwError,\r
-                                                                  dwLangId, szBuf, 511, NULL) )\r
-                       return WUFormatA("%s (0x%X)", szBuf, dwError);\r
-               else\r
-                       return WUFormatA("Unknown error (0x%X)", dwError);\r
-       }\r
-       inline CStdStringW WUSysMessageW(DWORD dwError, DWORD dwLangId=SS_DEFLANGID)\r
-       {\r
-               WCHAR szBuf[512];\r
-\r
-               if ( 0 != ::FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM, NULL, dwError,\r
-                                                                  dwLangId, szBuf, 511, NULL) )\r
-                       return WUFormatW(L"%s (0x%X)", szBuf, dwError);\r
-               else\r
-                       return WUFormatW(L"Unknown error (0x%X)", dwError);\r
-       }\r
-#endif\r
-\r
-// Define TCHAR based friendly names for some of these functions\r
-\r
-#ifdef UNICODE\r
-       #define CStdString                              CStdStringW\r
-       #define WUSysMessage                    WUSysMessageW\r
-       #define WUFormat                                WUFormatW\r
-#else\r
-       #define CStdString                              CStdStringA\r
-       #define WUSysMessage                    WUSysMessageA\r
-       #define WUFormat                                WUFormatA\r
-#endif\r
-\r
-// ...and some shorter names for the space-efficient\r
-\r
-#define WUSysMsg                                       WUSysMessage\r
-#define WUSysMsgA                                      WUSysMessageA\r
-#define WUSysMsgW                                      WUSysMessageW\r
-#define WUFmtA                                         WUFormatA\r
-#define        WUFmtW                                          WUFormatW\r
-#define WUFmt                                          WUFormat\r
-#define WULastErrMsg()                         WUSysMessage(::GetLastError())\r
-#define WULastErrMsgA()                                WUSysMessageA(::GetLastError())\r
-#define WULastErrMsgW()                                WUSysMessageW(::GetLastError())\r
-\r
-\r
-// -----------------------------------------------------------------------------\r
-// FUNCTIONAL COMPARATORS:\r
-// REMARKS:\r
-//             These structs are derived from the std::binary_function template.  They\r
-//             give us functional classes (which may be used in Standard C++ Library\r
-//             collections and algorithms) that perform case-insensitive comparisons of\r
-//             CStdString objects.  This is useful for maps in which the key may be the\r
-//              proper string but in the wrong case.\r
-// -----------------------------------------------------------------------------\r
-#define StdStringLessNoCaseW           SSLNCW  // avoid VC compiler warning 4786\r
-#define StdStringEqualsNoCaseW         SSENCW          \r
-#define StdStringLessNoCaseA           SSLNCA          \r
-#define StdStringEqualsNoCaseA         SSENCA          \r
-\r
-#ifdef UNICODE\r
-       #define StdStringLessNoCase             SSLNCW          \r
-       #define StdStringEqualsNoCase   SSENCW          \r
-#else\r
-       #define StdStringLessNoCase             SSLNCA          \r
-       #define StdStringEqualsNoCase   SSENCA          \r
-#endif\r
-\r
-struct StdStringLessNoCaseW\r
-       : std::binary_function<CStdStringW, CStdStringW, bool>\r
-{\r
-       inline\r
-       bool operator()(const CStdStringW& sLeft, const CStdStringW& sRight) const\r
-       { return ssicmp(sLeft.c_str(), sRight.c_str()) < 0; }\r
-};\r
-struct StdStringEqualsNoCaseW\r
-       : std::binary_function<CStdStringW, CStdStringW, bool>\r
-{\r
-       inline\r
-       bool operator()(const CStdStringW& sLeft, const CStdStringW& sRight) const\r
-       { return ssicmp(sLeft.c_str(), sRight.c_str()) == 0; }\r
-};\r
-struct StdStringLessNoCaseA\r
-       : std::binary_function<CStdStringA, CStdStringA, bool>\r
-{\r
-       inline\r
-       bool operator()(const CStdStringA& sLeft, const CStdStringA& sRight) const\r
-       { return ssicmp(sLeft.c_str(), sRight.c_str()) < 0; }\r
-};\r
-struct StdStringEqualsNoCaseA\r
-       : std::binary_function<CStdStringA, CStdStringA, bool>\r
-{\r
-       inline\r
-       bool operator()(const CStdStringA& sLeft, const CStdStringA& sRight) const\r
-       { return ssicmp(sLeft.c_str(), sRight.c_str()) == 0; }\r
-};\r
-\r
-// If we had to define our own version of TRACE above, get rid of it now\r
-\r
-#ifdef TRACE_DEFINED_HERE\r
-       #undef TRACE\r
-       #undef TRACE_DEFINED_HERE\r
-#endif\r
-\r
-\r
-// These std::swap specializations come courtesy of Mike Crusader. \r
-\r
-//namespace std\r
-//{\r
-//     inline void swap(CStdStringA& s1, CStdStringA& s2) throw()\r
-//     {\r
-//             s1.swap(s2);\r
-//     }\r
-//     template<>\r
-//     inline void swap(CStdStringW& s1, CStdStringW& s2) throw()\r
-//     {\r
-//             s1.swap(s2);\r
-//     }\r
-//}\r
-\r
-// Turn back on any Borland warnings we turned off.\r
-\r
-#ifdef __BORLANDC__\r
-    #pragma option pop  // Turn back on inline function warnings\r
-//     #pragma warn +inl   // Turn back on inline function warnings\r
-#endif\r
-\r
-#endif // #ifndef STDSTRING_H
\ No newline at end of file