Return to AutoPtr.h CVS log | Up to [Pegasus] / pegasus / src / Pegasus / Common |
File: [Pegasus] / pegasus / src / Pegasus / Common / AutoPtr.h
(download)
Revision: 1.11, Mon Jan 30 16:16:46 2006 UTC (18 years, 5 months ago) by karl Branch: MAIN CVS Tags: TASK_PEP233_EmbeddedInstSupport-merge_out_trunk, TASK_BUG_5314_IPC_REFACTORING_ROOT, TASK_BUG_5314_IPC_REFACTORING_BRANCH, TASK_BUG_5314_IPC_REFACTORING-V1, TASK_BUG_5191_QUEUE_CONSOLIDATION_ROOT, TASK_BUG_5191_QUEUE_CONSOLIDATION_BRANCH, TASK-TASK-BUG4011_WinLocalConnect-branch-New-root, TASK-TASK-BUG4011_WinLocalConnect-branch-New-merged_out_to_branch, TASK-TASK-BUG4011_WinLocalConnect-branch-New-merged_out_from_trunk, TASK-TASK-BUG4011_WinLocalConnect-branch-New-merged_in_to_trunk, TASK-TASK-BUG4011_WinLocalConnect-branch-New-merged_in_from_branch, TASK-TASK-BUG4011_WinLocalConnect-branch-New-branch, TASK-PEP268_SSLClientCertificatePropagation-root, TASK-PEP268_SSLClientCertificatePropagation-merged_out_to_branch, TASK-PEP268_SSLClientCertificatePropagation-merged_out_from_trunk, TASK-PEP268_SSLClientCertificatePropagation-merged_in_to_trunk, TASK-PEP268_SSLClientCertificatePropagation-merged_in_from_branch, TASK-PEP268_SSLClientCertificatePropagation-branch, TASK-PEP267_SLPReregistrationSupport-root, TASK-PEP267_SLPReregistrationSupport-merging_out_to_branch, TASK-PEP267_SLPReregistrationSupport-merging_out_from_trunk, TASK-PEP267_SLPReregistrationSupport-merged_out_to_branch, TASK-PEP267_SLPReregistrationSupport-merged_out_from_trunk, TASK-PEP267_SLPReregistrationSupport-merged_in_to_trunk, TASK-PEP267_SLPReregistrationSupport-merged_in_from_branch, TASK-PEP267_SLPReregistrationSupport-branch, TASK-PEP250_RPMProvider-root, TASK-PEP250_RPMProvider-merged_out_to_branch, TASK-PEP250_RPMProvider-merged_out_from_trunk, TASK-PEP250_RPMProvider-merged_in_to_trunk, TASK-PEP250_RPMProvider-merged_in_from_branch, TASK-PEP250_RPMProvider-branch, TASK-PEP245_CimErrorInfrastructure-root, TASK-PEP245_CimErrorInfrastructure-merged_out_to_branch, TASK-PEP245_CimErrorInfrastructure-merged_out_from_trunk, TASK-PEP245_CimErrorInfrastructure-merged_in_to_trunk, TASK-PEP245_CimErrorInfrastructure-merged_in_from_branch, TASK-PEP245_CimErrorInfrastructure-branch, TASK-PEP241_OpenPegasusStressTests-root, TASK-PEP241_OpenPegasusStressTests-merged_out_to_branch, TASK-PEP241_OpenPegasusStressTests-merged_out_from_trunk, TASK-PEP241_OpenPegasusStressTests-merged_in_to_trunk, TASK-PEP241_OpenPegasusStressTests-merged_in_from_branch, TASK-PEP241_OpenPegasusStressTests-branch, TASK-Bugs5690_3913_RemoteCMPI-root, TASK-Bugs5690_3913_RemoteCMPI-merged_out_to_branch, TASK-Bugs5690_3913_RemoteCMPI-merged_out_from_trunk, TASK-Bugs5690_3913_RemoteCMPI-merged_in_to_trunk, TASK-Bugs5690_3913_RemoteCMPI-merged_in_from_branch, TASK-Bugs5690_3913_RemoteCMPI-branch, TASK-Bug2021_RemoteCMPIonWindows-root, TASK-Bug2021_RemoteCMPIonWindows-merged_out_to_branch, TASK-Bug2021_RemoteCMPIonWindows-merged_out_from_trunk, TASK-Bug2021_RemoteCMPIonWindows-merged_in_to_trunk, TASK-Bug2021_RemoteCMPIonWindows-merged_in_from_branch, TASK-Bug2021_RemoteCMPIonWindows-branch, TASK-Bug2021_RCMPIonWindows-root, TASK-Bug2021_RCMPIonWindows-merged_out_to_branch, TASK-Bug2021_RCMPIonWindows-merged_out_from_trunk, TASK-Bug2021_RCMPIonWindows-merged_in_to_trunk, TASK-Bug2021_RCMPIonWindows-merged_in_from_branch, TASK-Bug2021_RCMPIonWindows-branch, TASK-BUG4011_WinLocalConnect-root, TASK-BUG4011_WinLocalConnect-merged_out_to_branch, TASK-BUG4011_WinLocalConnect-merged_out_from_trunk, TASK-BUG4011_WinLocalConnect-merged_in_to_trunk, TASK-BUG4011_WinLocalConnect-merged_in_from_branch, TASK-BUG4011_WinLocalConnect-branch-New, TASK-BUG4011_WinLocalConnect-branch, RELEASE_2_5_5-RC2, RELEASE_2_5_5-RC1, RELEASE_2_5_5, RELEASE_2_5_4-RC2, RELEASE_2_5_4-RC1, RELEASE_2_5_4, RELEASE_2_5_3-RC1, RELEASE_2_5_3, RELEASE_2_5_2-RC1, RELEASE_2_5_2, RELEASE_2_5_1-RC1, RELEASE_2_5_1, RELEASE_2_5-root, RELEASE_2_5-branch Changes since 1.10: +4 -2 lines BUG#: 4691 TITLE: Update Licenses to 2006 DESCRIPTION: Updates most of the licenses to 2006. The slp_client directories are excluded for the moment pending discussion. This change has passed unit and system tests. Note that this changes just about EVERY file in Pegasus. |
//%2006//////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; // IBM Corp.; EMC Corporation, The Open Group. // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; // EMC Corporation; VERITAS Software Corporation; The Open Group. // Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; // EMC Corporation; Symantec Corporation; The Open Group. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to // deal in the Software without restriction, including without limitation the // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or // sell copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. // //============================================================================== // // Author: Amit Arora, IBM (amita@in.ibm.com) (based on PEP101 by David Dillard) // // Modified By: Amit Arora, IBM (amita@in.ibm.com) for Bug#2168 // Amit Arora, IBM (amita@in.ibm.com) for Bug#2480 // David Dillard, VERITAS Software Corp. // (david.dillard@veritas.com) // //%///////////////////////////////////////////////////////////////////////////// #ifndef Pegasus_AutoPtr_h #define Pegasus_AutoPtr_h #include <Pegasus/Common/Config.h> PEGASUS_NAMESPACE_BEGIN /** This class provides a convenient way of disposing off a heap object. It automatically deletes the enclosed pointer on destruction. For example: <pre> A* a = new A; AutoPtr<A> dummy = a; </pre> When the AutoPtr object destructs, it frees the instance of A. This is particularly useful when a function has multiple returns. There are two classes here: AutoPtr<> and AutoArrayPtr<>. The AutoArrayPtr<> class is used when a pointer must be deleted using the array form as shown below: <pre> delete [] ptr; <pre> */ template<class X> class AutoPtr; template<class X> class AutoPtrRef { public: inline AutoPtrRef(AutoPtr<X> &ref) : _ref(ref) { // This block intentionally left blank } inline AutoPtr<X> get() { return(_ref); } private: AutoPtr<X> &_ref; }; template<class X> class AutoArrayPtr; template<class X> class AutoArrayPtrRef { public: inline AutoArrayPtrRef(AutoArrayPtr<X> &ref) : _ref(ref) { // This block intentionally left blank } inline AutoArrayPtr<X> get() { return(_ref); } private: AutoArrayPtr<X> &_ref; }; template<class X> class AutoPtr { public: // This constructor helps this AutoPtr to take ownership of the memory // object pointed by p. It also acts as a default constructor (if no // argument is passed, it assigns a value of "0" to _ptr. // Example: AutoPtr<SSLContext> sslContextA(new SSLContext()); // AutoPtr<SSLContext> sslContextB; // sslContextB here has _ptr set to "0". inline explicit AutoPtr(X* p = 0) throw() : _ptr(p) { // This block intentionally left blank } // Destructor makes sure to delete the object pointed by _ptr thus // avoiding memory leaks inline ~AutoPtr() throw() { delete _ptr; } // The copy constructor takes the ownership of the heap object from // the source AutoPtr object. And since there should be only one // legitimate owner, it sets the _ptr of the source to "0" inline AutoPtr(AutoPtrRef<X> &a) throw() : _ptr((a.get()).release()) { //a._ptr = 0; } inline AutoPtr(AutoPtr<X> &a) throw() : _ptr(a.release()) { } // Overloading of "=" operator makes sure that the ownership of the memory // gets transferred properly to 'this' AutoPtr object. // Example: AutoPtr<HTTPConnection> httpConnectionB = httpConnectionA; AutoPtr<X> &operator=(AutoPtr<X>& a) throw() { if ( this != &a ) reset(a.release()); return(*this); } inline AutoPtr<X> &operator=(AutoPtrRef<X> &a) throw() { reset((a.get()).release()); return(*this); } // This method can be used to get the pointer to heap object encapsulated // in 'this' AutoPtr object // Example: AutoPtr<classA> objA; // func1(objA.get(), NULL); // Here func1() is a function which takes first argument as pointer to the // object of classA. inline X *get() const throw() { return(_ptr); } // Returns the heap object itself (not the pointer to it) inline X &operator*() const throw() { return(*_ptr); } // A very important overloading, which allows you to directly use 'this' // object as a pointer, whenever accessing a member variable/function of // the object pointed to by _ptr. // Example: AutoPtr<classA> objA; // objA->funcA(); // funcA() is a function in the classA. Although objA is an AutoPtr, still // "->" operator would result in calling _ptr->funcA() because of this // overloading only. inline X *operator->() const throw() { return(_ptr); } // Relase the ownership of the memory object without deleting it ! // Return the pointer to the heap object and set _ptr to "0". inline X* release() throw() { X *t = _ptr; _ptr = 0; return(t); } // Delete the heap object and thus release ownership inline void reset(X *p = 0) throw() { if (p != _ptr) { delete _ptr; _ptr = p; } } AutoPtr(AutoPtrRef<X> obj) throw() : _ptr((obj.get()).get()) { // This block intentionally left blank } template<class Y> operator AutoPtrRef<Y>() throw() { return(AutoPtrRef<Y>(*this)); } template<class Y> operator AutoPtr<Y>() throw() { return(AutoPtr<Y>(release())); } private: // A pointer to the heap object X* _ptr; }; template<class X> class AutoArrayPtr { public: inline explicit AutoArrayPtr(X* p = 0) throw() : _ptr(p) { // This block intentionally left blank } inline ~AutoArrayPtr() throw() { delete [] _ptr; } inline AutoArrayPtr(AutoArrayPtrRef<X> &a) throw() : _ptr((a.get()).release()) { //a._ptr = 0; } inline AutoArrayPtr(AutoArrayPtr<X> &a) throw() : _ptr(a.release()) { } AutoArrayPtr<X> &operator=(AutoArrayPtr<X>& a) throw() { reset(a.release()); return(*this); } inline AutoArrayPtr<X> &operator=(AutoArrayPtrRef<X> &a) throw() { if ( this != a ) reset((a.get()).release()); return(*this); } inline X *get() const throw() { return(_ptr); } inline X &operator*() const throw() { return(*_ptr); } inline X *operator->() const throw() { return(_ptr); } inline X* release() throw() { X *t = _ptr; _ptr = 0; return(t); } inline void reset(X *p = 0) throw() { if (p != _ptr) { // use "[]" since _ptr is pointer to an array delete [] _ptr; _ptr = p; } } AutoArrayPtr(AutoArrayPtrRef<X> obj) throw() : _ptr((obj.get()).get()) { // This block intentionally left blank } template<class Y> operator AutoArrayPtrRef<Y>() throw() { return(AutoArrayPtrRef<Y>(*this)); } template<class Y> operator AutoArrayPtr<Y>() throw() { return(AutoArrayPtr<Y>(release())); } private: X* _ptr; }; PEGASUS_NAMESPACE_END #endif /* Pegasus_AutoPtr_h */
No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |