## Xalan-C++ API Documentation

### The Xalan C++ XSLT Processor Version 1.6

Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members

# XalanAutoPtr.hpp

Go to the documentation of this file.

    00001 /*
    00002  * The Apache Software License, Version 1.1
    00003  *
    00004  *
    00005  * Copyright (c) 1999-2002 The Apache Software Foundation.  All rights
    00006  * reserved.
    00007  *
    00008  * Redistribution and use in source and binary forms, with or without
    00009  * modification, are permitted provided that the following conditions
    00010  * are met:
    00011  *
    00012  * 1. Redistributions of source code must retain the above copyright
    00013  *    notice, this list of conditions and the following disclaimer.
    00014  *
    00015  * 2. Redistributions in binary form must reproduce the above copyright
    00016  *    notice, this list of conditions and the following disclaimer in
    00017  *    the documentation and/or other materials provided with the
    00018  *    distribution.
    00019  *
    00020  * 3. The end-user documentation included with the redistribution,
    00021  *    if any, must include the following acknowledgment:
    00022  *       "This product includes software developed by the
    00023  *        Apache Software Foundation (http://www.apache.org/)."
    00024  *    Alternately, this acknowledgment may appear in the software itself,
    00025  *    if and wherever such third-party acknowledgments normally appear.
    00026  *
    00027  * 4. The names "Xalan" and "Apache Software Foundation" must
    00028  *    not be used to endorse or promote products derived from this
    00029  *    software without prior written permission. For written
    00030  *    permission, please contact apache@apache.org.
    00031  *
    00032  * 5. Products derived from this software may not be called "Apache",
    00033  *    nor may "Apache" appear in their name, without prior written
    00034  *    permission of the Apache Software Foundation.
    00035  *
    00036  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
    00037  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
    00038  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    00039  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
    00040  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    00041  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    00042  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
    00043  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
    00044  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    00045  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
    00046  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    00047  * SUCH DAMAGE.
    00048  * ====================================================================
    00049  *
    00050  * This software consists of voluntary contributions made by many
    00051  * individuals on behalf of the Apache Software Foundation and was
    00052  * originally based on software copyright (c) 1999, International
    00053  * Business Machines, Inc., http://www.ibm.com.  For more
    00054  * information on the Apache Software Foundation, please see
    00055  * <http://www.apache.org/>.
    00056  */
    00057 #if !defined(XALANAUTOPTR_HEADER_GUARD_1357924680)
    00058 #define XALANAUTOPTR_HEADER_GUARD_1357924680
    00059
    00060
    00061
    00062 // Base include file.  Must be first.
    00063 #include <xalanc/PlatformSupport/PlatformSupportDefinitions.hpp>
    00064
    00065
    00066
    00067 #include <cstddef>
    00068
    00069
    00070
    00071 XALAN_CPP_NAMESPACE_BEGIN
    00072
    00073
    00074
    00075 // We're using our own auto_ptr-like class due to wide
    00076 // variations amongst the varous platforms we have to
    00077 // support
    00078 template<class Type>
    00079 class XalanAutoPtr
    00080 {
    00081 public:
    00082
    00083     XalanAutoPtr(Type*  thePointer = 0) :
    00084         m_pointer(thePointer)
    00085     {
    00086     }
    00087
    00088     XalanAutoPtr(const XalanAutoPtr<Type>&  theSource) :
    00089         m_pointer(((XalanAutoPtr<Type>&)theSource).release())
    00090     {
    00091     }
    00092
    00093     XalanAutoPtr<Type>&
    00094 	operator=(XalanAutoPtr<Type>&  theRHS)
    00095     {
    00096         if (this != &theRHS)
    00097         {
    00098             // This test ought not to be necessary, but
    00099             // MSVC 6.0 calls delete, which checks for 0.
    00100             // The problem with that is the locking is
    00101             // extremely expensive.
    00102             if (m_pointer != 0)
    00103             {
    00104                 delete m_pointer;
    00105             }
    00106
    00107             m_pointer = theRHS.release();
    00108         }
    00109
    00110         return *this;
    00111     }
    00112
    00113     ~XalanAutoPtr()
    00114     {
    00115         // See note in operator=() about this...
    00116         if (m_pointer != 0)
    00117         {
    00118             delete m_pointer;
    00119         }
    00120     }
    00121
    00122     Type&
    00123     operator*() const
    00124     {
    00125         return *m_pointer;
    00126     }
    00127
    00128     Type*
    00129     operator->() const
    00130     {
    00131         return m_pointer;
    00132     }
    00133
    00134     Type*
    00135     get() const
    00136     {
    00137         return m_pointer;
    00138     }
    00139
    00140     Type*
    00141     release()
    00142     {
    00143         Type* const temp = m_pointer;
    00144
    00145         m_pointer = 0;
    00146
    00147         return temp;
    00148     }
    00149
    00150     void
    00151     reset(Type*     thePointer = 0)
    00152     {
    00153         // See note in operator=() about this...
    00154         if (m_pointer != 0)
    00155         {
    00156             delete m_pointer;
    00157         }
    00158
    00159         m_pointer = thePointer;
    00160     }
    00161
    00162 private:
    00163
    00164     Type*   m_pointer;
    00165 };
    00166
    00167
    00168
    00169 // A class similar to XalanAutoPtr, but for arrays.
    00170 template<class Type>
    00171 class XalanArrayAutoPtr
    00172 {
    00173 public:
    00174
    00175     XalanArrayAutoPtr(Type*     thePointer = 0) :
    00176         m_pointer(thePointer)
    00177     {
    00178     }
    00179
    00180     XalanArrayAutoPtr(const XalanArrayAutoPtr<Type>&    theSource) :
    00181         m_pointer(((XalanArrayAutoPtr<Type>&)theSource).release())
    00182     {
    00183     }
    00184
    00185     XalanArrayAutoPtr<Type>&
    00186 	operator=(XalanArrayAutoPtr<Type>& theRHS)
    00187     {
    00188         if (this != &theRHS)
    00189         {
    00190             // This test ought not to be necessary, but
    00191             // MSVC 6.0 calls delete, which checks for 0.
    00192             // The problem with that is the locking is
    00193             // extremely expensive.
    00194             if (m_pointer != 0)
    00195             {
    00196                 delete [] m_pointer;
    00197             }
    00198
    00199             m_pointer = theRHS.release();
    00200         }
    00201
    00202         return *this;
    00203     }
    00204
    00205     ~XalanArrayAutoPtr()
    00206     {
    00207         // See note in operator=() about this...
    00208         if (m_pointer != 0)
    00209         {
    00210             delete [] m_pointer;
    00211         }
    00212     }
    00213
    00214     Type&
    00215     operator*() const
    00216     {
    00217         return *m_pointer;
    00218     }
    00219
    00220     Type&
    00221 #if defined(XALAN_STRICT_ANSI_HEADERS)
    00222 	operator[](std::size_t index) const
    00223 #else
    00224 	operator[](size_t  index) const
    00225 #endif
    00226     {
    00227         return m_pointer[index];
    00228     }
    00229
    00230     Type*
    00231     get() const
    00232     {
    00233         return m_pointer;
    00234     }
    00235
    00236     Type*
    00237     release()
    00238     {
    00239         Type* const temp = m_pointer;
    00240
    00241         m_pointer = 0;
    00242
    00243         return temp;
    00244     }
    00245
    00246     void
    00247     reset(Type*     thePointer = 0)
    00248     {
    00249         // See note in operator=() about this...
    00250         if (m_pointer != 0)
    00251         {
    00252             delete [] m_pointer;
    00253         }
    00254
    00255         m_pointer = thePointer;
    00256     }
    00257
    00258 private:
    00259
    00260     Type*   m_pointer;
    00261 };
    00262
    00263
    00264
    00265 XALAN_CPP_NAMESPACE_END
    00266
    00267
    00268
    00269 #endif  // if !defined(XALANAUTOPTR_HEADER_GUARD_1357924680)

Interpreting class diagrams

Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.

Xalan-C++ XSLT Processor Version 1.6 Copyright © 2000, 2001, 2002, 2003 The Apache Software Foundation. All Rights Reserved.