00001 #ifndef DOMStringImpl_HEADER_GUARD_
00002 #define DOMStringImpl_HEADER_GUARD_
00003
00004 /*
00005 * The Apache Software License, Version 1.1
00006 *
00007 * Copyright (c) 1999-2000 The Apache Software Foundation. All rights
00008 * reserved.
00009 *
00010 * Redistribution and use in source and binary forms, with or without
00011 * modification, are permitted provided that the following conditions
00012 * are met:
00013 *
00014 * 1. Redistributions of source code must retain the above copyright
00015 * notice, this list of conditions and the following disclaimer.
00016 *
00017 * 2. Redistributions in binary form must reproduce the above copyright
00018 * notice, this list of conditions and the following disclaimer in
00019 * the documentation and/or other materials provided with the
00020 * distribution.
00021 *
00022 * 3. The end-user documentation included with the redistribution,
00023 * if any, must include the following acknowledgment:
00024 * "This product includes software developed by the
00025 * Apache Software Foundation (http://www.apache.org/)."
00026 * Alternately, this acknowledgment may appear in the software itself,
00027 * if and wherever such third-party acknowledgments normally appear.
00028 *
00029 * 4. The names "Xerces" and "Apache Software Foundation" must
00030 * not be used to endorse or promote products derived from this
00031 * software without prior written permission. For written
00032 * permission, please contact apache\@apache.org.
00033 *
00034 * 5. Products derived from this software may not be called "Apache",
00035 * nor may "Apache" appear in their name, without prior written
00036 * permission of the Apache Software Foundation.
00037 *
00038 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
00039 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
00040 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
00041 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
00042 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
00043 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
00044 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
00045 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
00046 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00047 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
00048 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00049 * SUCH DAMAGE.
00050 * ====================================================================
00051 *
00052 * This software consists of voluntary contributions made by many
00053 * individuals on behalf of the Apache Software Foundation, and was
00054 * originally based on software copyright (c) 1999, International
00055 * Business Machines, Inc., http://www.ibm.com . For more information
00056 * on the Apache Software Foundation, please see
00057 * <http://www.apache.org/>.
00058 */
00059
00060 /*
00061 * $Log: DOMStringImpl.hpp,v $
00062 * Revision 1.8 2000/05/09 00:22:30 andyh
00063 * Memory Cleanup. XMLPlatformUtils::Terminate() deletes all lazily
00064 * allocated memory; memory leak checking tools will no longer report
00065 * that leaks exist. (DOM GetElementsByTagID temporarily removed
00066 * as part of this.)
00067 *
00068 * Revision 1.7 2000/03/02 19:53:52 roddey
00069 * This checkin includes many changes done while waiting for the
00070 * 1.1.0 code to be finished. I can't list them all here, but a list is
00071 * available elsewhere.
00072 *
00073 * Revision 1.6 2000/02/24 20:11:27 abagchi
00074 * Swat for removing Log from API docs
00075 *
00076 * Revision 1.5 2000/02/06 07:47:27 rahulj
00077 * Year 2K copyright swat.
00078 *
00079 * Revision 1.4 2000/02/04 05:46:31 andyh
00080 * Change offsets and lengths form signed to unsigned
00081 *
00082 * Revision 1.3 2000/01/29 00:39:08 andyh
00083 * Redo synchronization in DOMStringHandle allocator. There
00084 * was a bug in the use of Compare and Swap. Switched to mutexes.
00085 *
00086 * Changed a few plain deletes to delete [].
00087 *
00088 * Revision 1.2 2000/01/12 19:55:14 aruna1
00089 * Included header for size_t
00090 *
00091 * Revision 1.1 2000/01/05 22:16:26 robweir
00092 * Move DOMString implementation class declarations into a new
00093 * file: DOMStringImpl.hpp. Include this header in DOMString.hpp
00094 * for XML_DEBUG builds so the underlying character array will be
00095 * visible in the debugger. <robert_weir@lotus.com>
00096 *
00097 *
00098 */
00099
00100
00101 //
00102 // This file is part of the internal implementation of the C++ XML DOM.
00103 // It should NOT be included or used directly by application programs.
00104 //
00105
00106
00107 #include <util/XercesDefs.hpp>
00108 #include <util/Mutexes.hpp>
00109 #include <stdio.h>
00110
00111
00112 class DOMStringData
00113 {
00114 public:
00115 unsigned int fBufferLength;
00116 int fRefCount;
00117 XMLCh fData[1];
00118
00119 static DOMStringData *allocateBuffer(unsigned int length);
00120 inline void addRef();
00121 inline void removeRef();
00122 };
00123
00124 class DOMStringHandle
00125 {
00126 public:
00127 unsigned int fLength; // The logical length of the DOMString.
00128 // This may be shorter than the buffer length.
00129 int fRefCount; // The number of DOMString objects pointing to
00130 // this string handle.
00131 DOMStringData *fDSData; // Pointer to the string buffer. May be null.
00132
00133 void *operator new( size_t sizeToAlloc); // StringHandles have custom, optimized
00134 void operator delete( void *pvMem ); // memory allocation.
00135
00136
00137 private:
00138 static void *freeListPtr; // Head of the linked list of unallocated String Handles
00139
00140 static DOMStringHandle *blockListPtr; // Head of the linked list of memory blocks from which
00141 // string handles are sub-allocated.
00142
00143 public:
00144 static DOMStringHandle *createNewStringHandle(unsigned int bufLength);
00145 DOMStringHandle *cloneStringHandle();
00146 inline void addRef();
00147 inline void removeRef();
00148 ~DOMStringHandle() {};
00149 static void DOMStringCleanup();
00150 private:
00151 inline DOMStringHandle() {};
00152 static inline XMLMutex &getMutex();
00153 };
00154
00155
00156 #endif
00157