00001 /* 00002 * The Apache Software License, Version 1.1 00003 * 00004 * Copyright (c) 1999-2002 The Apache Software Foundation. All rights 00005 * reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions 00009 * are met: 00010 * 00011 * 1. Redistributions of source code must retain the above copyright 00012 * notice, this list of conditions and the following disclaimer. 00013 * 00014 * 2. Redistributions in binary form must reproduce the above copyright 00015 * notice, this list of conditions and the following disclaimer in 00016 * the documentation and/or other materials provided with the 00017 * distribution. 00018 * 00019 * 3. The end-user documentation included with the redistribution, 00020 * if any, must include the following acknowledgment: 00021 * "This product includes software developed by the 00022 * Apache Software Foundation (http://www.apache.org/)." 00023 * Alternately, this acknowledgment may appear in the software itself, 00024 * if and wherever such third-party acknowledgments normally appear. 00025 * 00026 * 4. The names "Xerces" and "Apache Software Foundation" must 00027 * not be used to endorse or promote products derived from this 00028 * software without prior written permission. For written 00029 * permission, please contact apache\@apache.org. 00030 * 00031 * 5. Products derived from this software may not be called "Apache", 00032 * nor may "Apache" appear in their name, without prior written 00033 * permission of the Apache Software Foundation. 00034 * 00035 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED 00036 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 00037 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00038 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR 00039 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00040 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00041 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 00042 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 00043 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00044 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 00045 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 00046 * SUCH DAMAGE. 00047 * ==================================================================== 00048 * 00049 * This software consists of voluntary contributions made by many 00050 * individuals on behalf of the Apache Software Foundation, and was 00051 * originally based on software copyright (c) 1999, International 00052 * Business Machines, Inc., http://www.ibm.com . For more information 00053 * on the Apache Software Foundation, please see 00054 * <http://www.apache.org/>. 00055 */ 00056 00057 /* 00058 * $Log: RefVectorOf.hpp,v $ 00059 * Revision 1.1 2002/05/11 21:09:43 bhavani 00060 * CR#CR062582# adding xercesc 1.7 file 00061 * 00062 * Revision 1.2 2002/02/05 13:11:06 tng 00063 * [Bug 6114] Memory leaks on iDOM getElementsByTagName(). 00064 * 00065 * Revision 1.1.1.1 2002/02/01 22:22:12 peiyongz 00066 * sane_include 00067 * 00068 * Revision 1.5 2001/06/25 13:01:52 knoaman 00069 * Add constraint checking on elements in complex types to prevent same 00070 * element names from having different definitions - use substitueGroups. 00071 * 00072 * Revision 1.4 2000/03/02 19:54:45 roddey 00073 * This checkin includes many changes done while waiting for the 00074 * 1.1.0 code to be finished. I can't list them all here, but a list is 00075 * available elsewhere. 00076 * 00077 * Revision 1.3 2000/02/24 20:05:25 abagchi 00078 * Swat for removing Log from API docs 00079 * 00080 * Revision 1.2 2000/02/06 07:48:03 rahulj 00081 * Year 2K copyright swat. 00082 * 00083 * Revision 1.1.1.1 1999/11/09 01:05:05 twl 00084 * Initial checkin 00085 * 00086 * Revision 1.2 1999/11/08 20:45:13 rahul 00087 * Swat for adding in Product name and CVS comment log variable. 00088 * 00089 */ 00090 00091 #if !defined(REFVECTOROF_HPP) 00092 #define REFVECTOROF_HPP 00093 00094 #include <xercesc/util/XercesDefs.hpp> 00095 #include <xercesc/util/ArrayIndexOutOfBoundsException.hpp> 00096 #include <xercesc/util/XMLEnumerator.hpp> 00097 00098 00099 template <class TElem> class RefVectorOf 00100 { 00101 public : 00102 // ----------------------------------------------------------------------- 00103 // Constructors and Destructor 00104 // ----------------------------------------------------------------------- 00105 RefVectorOf(const unsigned int maxElems, const bool adoptElems = true); 00106 ~RefVectorOf(); 00107 00108 00109 // ----------------------------------------------------------------------- 00110 // Element management 00111 // ----------------------------------------------------------------------- 00112 void addElement(TElem* const toAdd); 00113 void setElementAt(TElem* const toSet, const unsigned int setAt); 00114 void insertElementAt(TElem* const toInsert, const unsigned int insertAt); 00115 TElem* orphanElementAt(const unsigned int orphanAt); 00116 void removeAllElements(); 00117 void removeElementAt(const unsigned int removeAt); 00118 void removeLastElement(); 00119 bool containsElement(const TElem* const toCheck); 00120 void cleanup(); 00121 void reinitialize(); 00122 00123 00124 // ----------------------------------------------------------------------- 00125 // Getter methods 00126 // ----------------------------------------------------------------------- 00127 unsigned int curCapacity() const; 00128 const TElem* elementAt(const unsigned int getAt) const; 00129 TElem* elementAt(const unsigned int getAt); 00130 unsigned int size() const; 00131 00132 00133 // ----------------------------------------------------------------------- 00134 // Miscellaneous 00135 // ----------------------------------------------------------------------- 00136 void ensureExtraCapacity(const unsigned int length); 00137 00138 00139 private: 00140 // ----------------------------------------------------------------------- 00141 // Data members 00142 // ----------------------------------------------------------------------- 00143 bool fAdoptedElems; 00144 unsigned int fCurCount; 00145 unsigned int fMaxCount; 00146 TElem** fElemList; 00147 }; 00148 00149 00150 // 00151 // An enumerator for a reference vector. It derives from the basic enumerator 00152 // class, so that value vectors can be generically enumerated. 00153 // 00154 template <class TElem> class RefVectorEnumerator : public XMLEnumerator<TElem> 00155 { 00156 public : 00157 // ----------------------------------------------------------------------- 00158 // Constructors and Destructor 00159 // ----------------------------------------------------------------------- 00160 RefVectorEnumerator 00161 ( 00162 RefVectorOf<TElem>* const toEnum 00163 , const bool adopt = false 00164 ); 00165 ~RefVectorEnumerator(); 00166 00167 00168 // ----------------------------------------------------------------------- 00169 // Enum interface 00170 // ----------------------------------------------------------------------- 00171 bool hasMoreElements() const; 00172 TElem& nextElement(); 00173 void Reset(); 00174 00175 00176 private : 00177 // ----------------------------------------------------------------------- 00178 // Data Members 00179 // 00180 // fAdopted 00181 // Indicates whether we have adopted the passed vector. If so then 00182 // we delete the vector when we are destroyed. 00183 // 00184 // fCurIndex 00185 // This is the current index into the vector. 00186 // 00187 // fToEnum 00188 // The reference vector being enumerated. 00189 // ----------------------------------------------------------------------- 00190 bool fAdopted; 00191 unsigned int fCurIndex; 00192 RefVectorOf<TElem>* fToEnum; 00193 }; 00194 00195 #if !defined(XERCES_TMPLSINC) 00196 #include <xercesc/util/RefVectorOf.c> 00197 #endif 00198 00199 #endif