diff options
-rwxr-xr-x | salhelper/inc/salhelper/simplereferenceobject.hxx | 150 | ||||
-rwxr-xr-x | salhelper/source/simplereferenceobject.cxx | 114 |
2 files changed, 264 insertions, 0 deletions
diff --git a/salhelper/inc/salhelper/simplereferenceobject.hxx b/salhelper/inc/salhelper/simplereferenceobject.hxx new file mode 100755 index 000000000000..0cbb303b8736 --- /dev/null +++ b/salhelper/inc/salhelper/simplereferenceobject.hxx @@ -0,0 +1,150 @@ +/************************************************************************* + * + * $RCSfile: simplereferenceobject.hxx,v $ + * + * $Revision: 1.1 $ + * + * last change: $Author: sb $ $Date: 2001-06-05 15:20:37 $ + * + * The Contents of this file are made available subject to the terms of + * either of the following licenses + * + * - GNU Lesser General Public License Version 2.1 + * - Sun Industry Standards Source License Version 1.1 + * + * Sun Microsystems Inc., October, 2000 + * + * GNU Lesser General Public License Version 2.1 + * ============================================= + * Copyright 2000 by Sun Microsystems, Inc. + * 901 San Antonio Road, Palo Alto, CA 94303, USA + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License version 2.1, as published by the Free Software Foundation. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, + * MA 02111-1307 USA + * + * + * Sun Industry Standards Source License Version 1.1 + * ================================================= + * The contents of this file are subject to the Sun Industry Standards + * Source License Version 1.1 (the "License"); You may not use this file + * except in compliance with the License. You may obtain a copy of the + * License at http://www.openoffice.org/license.html. + * + * Software provided under this License is provided on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, + * WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS, + * MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING. + * See the License for the specific provisions governing your rights and + * obligations concerning the Software. + * + * The Initial Developer of the Original Code is: Sun Microsystems, Inc. + * + * Copyright: 2000 by Sun Microsystems, Inc. + * + * All Rights Reserved. + * + * Contributor(s): _______________________________________ + * + * + ************************************************************************/ + +#ifndef _SALHELPER_SIMPLEREFERENCEOBJECT_HXX_ +#define _SALHELPER_SIMPLEREFERENCEOBJECT_HXX_ + +#ifndef _OSL_INTERLCK_H_ +#include "osl/interlck.h" +#endif +#ifndef _SAL_TYPES_H_ +#include "sal/types.h" +#endif + +#ifndef INCLUDED_CSTDDEF +#include <cstddef> +#define INCLUDED_CSTDDEF +#endif +#ifndef INCLUDED_NEW +#include <new> +#define INCLUDED_NEW +#endif + +namespace salhelper { + +class SimpleReferenceObject +{ +public: + inline SimpleReferenceObject() SAL_THROW(()): m_nCount(0) {} + + /** @ATTENTION + The results are undefined if, for any individual instance of + SimpleReferenceObject, the total number of calls to acquire() exceeds + the total number of calls to release() by a plattform dependent amount + (which, hopefully, is quite large). + */ + inline void acquire() SAL_THROW(()) + { osl_incrementInterlockedCount(&m_nCount); } + + inline void release() SAL_THROW(()) + { if (osl_decrementInterlockedCount(&m_nCount) == 0) delete this; } + + /** @descr + The reason to have class local operators new and delete here is + technical. Imagine a class D derived from SimpleReferenceObject, but + implemented in another shared library that happens to use different + global operators new and delete from those used in this shared library + (which, sadly, seems to be possible with shared libraries...). Now, + without the class local operators new and delete here, a code sequence + like "new D" would use the global operator new as found in the other + shared library, while the code sequence "delete this" in release() + would use the global operator delete as found in this shared library + ---and these two operators would not be guaranteed to match. + + @descr + There are no overloaded operators new and delete for placement new + here, because it is felt that the concept of placement new does not + work well with the concept of a reference counted object; so it seems + best to simply leave those operators out. + + @descr + The same problem as with operators new and delete would also be there + with operators new[] and delete[]. But since arrays of reference + counted objects are of no use, anyway, it seems best to simply declare + and not define (private) operators new[] and delete[]. + */ + static void * operator new(std::size_t nSize) SAL_THROW((std::bad_alloc)); + + static void * operator new(std::size_t nSize, + std::nothrow_t const & rNothrow) + SAL_THROW(()); + + static void operator delete(void * pPtr) SAL_THROW(()); + + static void operator delete(void * pPtr, std::nothrow_t const & rNothrow) + SAL_THROW(()); + +protected: + virtual ~SimpleReferenceObject() SAL_THROW(()); + +private: + oslInterlockedCount m_nCount; + + SimpleReferenceObject(SimpleReferenceObject &); // not implemented + void operator =(SimpleReferenceObject); // not implemented + + static void * operator new[](std::size_t); // not implemented + static void operator delete[](void * pPtr); // not implemented +}; + +} + +#endif // _SALHELPER_SIMPLEREFERENCEOBJECT_HXX_ diff --git a/salhelper/source/simplereferenceobject.cxx b/salhelper/source/simplereferenceobject.cxx new file mode 100755 index 000000000000..c468159ca16a --- /dev/null +++ b/salhelper/source/simplereferenceobject.cxx @@ -0,0 +1,114 @@ +/************************************************************************* + * + * $RCSfile: simplereferenceobject.cxx,v $ + * + * $Revision: 1.1 $ + * + * last change: $Author: sb $ $Date: 2001-06-05 15:21:32 $ + * + * The Contents of this file are made available subject to the terms of + * either of the following licenses + * + * - GNU Lesser General Public License Version 2.1 + * - Sun Industry Standards Source License Version 1.1 + * + * Sun Microsystems Inc., October, 2000 + * + * GNU Lesser General Public License Version 2.1 + * ============================================= + * Copyright 2000 by Sun Microsystems, Inc. + * 901 San Antonio Road, Palo Alto, CA 94303, USA + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License version 2.1, as published by the Free Software Foundation. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, + * MA 02111-1307 USA + * + * + * Sun Industry Standards Source License Version 1.1 + * ================================================= + * The contents of this file are subject to the Sun Industry Standards + * Source License Version 1.1 (the "License"); You may not use this file + * except in compliance with the License. You may obtain a copy of the + * License at http://www.openoffice.org/license.html. + * + * Software provided under this License is provided on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, + * WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS, + * MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING. + * See the License for the specific provisions governing your rights and + * obligations concerning the Software. + * + * The Initial Developer of the Original Code is: Sun Microsystems, Inc. + * + * Copyright: 2000 by Sun Microsystems, Inc. + * + * All Rights Reserved. + * + * Contributor(s): _______________________________________ + * + * + ************************************************************************/ + +#ifndef _SALHELPER_SIMPLEREFERENCEOBJECT_HXX_ +#include "salhelper/simplereferenceobject.hxx" +#endif + +#ifndef _OSL_DIAGNOSE_H_ +#include "osl/diagnose.h" +#endif + +#ifndef INCLUDED_NEW +#include <new> +#define INCLUDED_NEW +#endif + +using salhelper::SimpleReferenceObject; + +SimpleReferenceObject::~SimpleReferenceObject() SAL_THROW(()) +{ + OSL_ASSERT(m_nCount == 0); +} + +void * SimpleReferenceObject::operator new(std::size_t nSize) + SAL_THROW((std::bad_alloc)) +{ + return ::operator new(nSize); +} + +void * SimpleReferenceObject::operator new(std::size_t nSize, + std::nothrow_t const & rNothrow) + SAL_THROW(()) +{ +#if defined WNT + return ::operator new(nSize); + // WNT lacks a global nothrow operator new... +#else // WNT + return ::operator new(nSize, rNothrow); +#endif // WNT +} + +void SimpleReferenceObject::operator delete(void * pPtr) SAL_THROW(()) +{ + ::operator delete(pPtr); +} + +void SimpleReferenceObject::operator delete(void * pPtr, + std::nothrow_t const & rNothrow) + SAL_THROW(()) +{ +#if defined WNT + ::operator delete(pPtr); // WNT lacks a global nothrow operator delete... +#else // WNT + ::operator delete(pPtr, rNothrow); +#endif // WNT +} |