Public Member Functions
| ||ConstHandle (const RCP< const PointerType > &ptr)|
| ||Construct with an existing RCP. |
| ||ConstHandle (const ConstHandleable< PointerType > *ptr)|
| ||Construct with a raw pointer to a ConstHandleable. This will make a call to rcp(), thus removing that call from the user interface. |
|const RCP< const PointerType > & ||constPtr () const |
| ||Read-only access to the underlying smart pointer. |
|const PointerType *const ||rawPtr ()|
| ||Access to raw pointer. |
Protected Member Functions
| ||ConstHandle ()|
| ||The empty ctor will only be called by Handle ctors. |
|void ||setRcp (const RCP< PointerType > &ptr)|
| ||This function is needed in Handle ctors. |
|RCP< PointerType > ||nonConstPtr () const |
| ||Protected non-const access to the underlying smart pointer. |
|RCP< const PointerType > ||ptr_|
| || |
class Teuchos::ConstHandle< PointerType >
Templated handle class with strong const protection.
In writing derived types, it is usually simplest to use the TEUCHOS_CONST_HANDLE_CTORS macro to generate boilerplate constructor code.
There are two modes of construction: construction from an existing RCP,
RCP<const Base> r = rcp(new Derived(blahblah));
ConstHandle<Base> h = r;
and construction from a raw pointer,
ConstHandle<Base> h = new Derived(blahblah);
The second form makes the code slightly cleaner. Note that to use this second form, it is necessary that Derived implement the ConstHandleable interface; this is necessary to avoid any implicit conversions from just any raw pointer to a smart pointer.
Note that the first form with rcp() must be used whenever the object being handled has been allocated on the stack (using rcp(ptr,false) of course).
Definition at line 79 of file Teuchos_Handle.hpp.