mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-05-26 11:05:31 +03:00
113 lines
4.0 KiB
C++
Executable File
113 lines
4.0 KiB
C++
Executable File
// Created on: 2009-01-30
|
|
// Created by: Andrey BETENEV (abv)
|
|
// Copyright (c) 2009-2012 OPEN CASCADE SAS
|
|
//
|
|
// The content of this file is subject to the Open CASCADE Technology Public
|
|
// License Version 6.5 (the "License"). You may not use the content of this file
|
|
// except in compliance with the License. Please obtain a copy of the License
|
|
// at http://www.opencascade.org and read it completely before using this file.
|
|
//
|
|
// The Initial Developer of the Original Code is Open CASCADE S.A.S., having its
|
|
// main offices at: 1, place des Freres Montgolfier, 78280 Guyancourt, France.
|
|
//
|
|
// The Original Code and all software distributed under the License is
|
|
// distributed on an "AS IS" basis, without warranty of any kind, and the
|
|
// Initial Developer hereby disclaims all such warranties, including without
|
|
// limitation, any warranties of merchantability, fitness for a particular
|
|
// purpose or non-infringement. Please see the License for the specific terms
|
|
// and conditions governing the rights and limitations under the License.
|
|
|
|
|
|
#ifndef NCollection_Handle_HeaderFile
|
|
#define NCollection_Handle_HeaderFile
|
|
|
|
#include <MMgt_TShared.hxx>
|
|
|
|
//! Standard type function allowing to check that contained object is Handle
|
|
Standard_EXPORT const Handle(Standard_Type)& STANDARD_TYPE(NCollection_Handle);
|
|
|
|
//! Purpose: This template class is used to define Handle adaptor
|
|
//! for allocated dynamically objects of arbitrary type.
|
|
//!
|
|
//! The advantage is that this handle will automatically destroy
|
|
//! the object when last referred Handle is destroyed (i.e. it is a
|
|
//! typical smart pointer), and that it can be handled as
|
|
//! Handle(Standard_Transient) in OCCT components.
|
|
//!
|
|
//! Use it as follows:
|
|
//!
|
|
//! NCollection_Handle<T> aPtr = new T (...);
|
|
//!
|
|
//! aPtr->Method(...);
|
|
//!
|
|
//! Handle(Standard_Transient) aBase = aPtr;
|
|
//! if ( aBase->IsKind(STANDARD_TYPE(NCollection_Handle)) )
|
|
//! {
|
|
//! NCollection_Handle<T> aPtr2 = NCollection_Handle<T>::DownCast (aBase);
|
|
//! if ( ! aPtr2.IsNull() )
|
|
//! aPtr2->Method2();
|
|
//! }
|
|
|
|
template <class T>
|
|
class NCollection_Handle : public Handle_Standard_Transient
|
|
{
|
|
private:
|
|
|
|
//! Internal adaptor class wrapping actual type
|
|
//! and enhancing it by reference counter inherited from
|
|
//! Standard_Transient
|
|
class Ptr : public Standard_Transient
|
|
{
|
|
public:
|
|
|
|
//! Constructor: stores pointer to the object
|
|
Ptr (T* theObj) { myPtr = theObj; }
|
|
|
|
//! Destructor deletes the object
|
|
~Ptr () { if ( myPtr ) delete myPtr; myPtr = 0; }
|
|
|
|
//! Implementation of DynamicType() method
|
|
const Handle(Standard_Type)& DynamicType() const
|
|
{ return STANDARD_TYPE(NCollection_Handle); }
|
|
|
|
public:
|
|
T* myPtr; //!< Pointer to the object
|
|
};
|
|
|
|
//! Constructor of handle from pointer on newly allocated object.
|
|
//! Note that additional argument is used to avoid ambiguity with
|
|
//! public constructor from pointer when Handle is intilialized by 0.
|
|
NCollection_Handle (Ptr* thePtr, int)
|
|
: Handle_Standard_Transient (thePtr) {}
|
|
|
|
public:
|
|
|
|
//! Default constructor; creates null handle
|
|
NCollection_Handle () {}
|
|
|
|
//! Constructor of handle from pointer on newly allocated object
|
|
NCollection_Handle (T* theObject)
|
|
: Handle_Standard_Transient (theObject ? new Ptr (theObject) : 0) {}
|
|
|
|
//! Cast handle to contained type
|
|
T* operator -> () { return ((Ptr*)ControlAccess())->myPtr; }
|
|
|
|
//! Cast handle to contained type
|
|
const T* operator -> () const { return ((Ptr*)ControlAccess())->myPtr; }
|
|
|
|
//! Cast handle to contained type
|
|
T& operator * () { return *((Ptr*)ControlAccess())->myPtr; }
|
|
|
|
//! Cast handle to contained type
|
|
const T& operator * () const { return *((Ptr*)ControlAccess())->myPtr; }
|
|
|
|
//! Downcast arbitrary Handle to the argument type if contained
|
|
//! object is Handle for this type; returns null otherwise
|
|
static NCollection_Handle<T> DownCast (const Handle(Standard_Transient)& theOther)
|
|
{
|
|
return NCollection_Handle<T> (theOther.IsNull() ? 0 : dynamic_cast<Ptr*> (theOther.operator->()), 0);
|
|
}
|
|
};
|
|
|
|
#endif
|