A class for managing references or pointers (no reference counting). More...

#include <refPtr.H>

Inheritance diagram for refPtr< T >:

[legend]

Public Types
typedef T	element_type
	Type of object being managed or referenced.
typedef T *	pointer
	Pointer to type of object being managed or referenced.
typedef Foam::refCount::zero	refCount
	Null reference counter class.

Public Member Functions
constexpr	refPtr () noexcept
	Construct with no managed pointer.
constexpr	refPtr (std::nullptr_t) noexcept
	Implicit construct from literal nullptr: no managed pointer.
constexpr	refPtr (T *p) noexcept
	Construct, taking ownership of the pointer.
constexpr	refPtr (const T &obj) noexcept
	Implicit construct for a const reference to an object.
	refPtr (refPtr< T > &&rhs) noexcept
	Move construct, transferring ownership.
	refPtr (const refPtr< T > &rhs)
	Copy construct (shallow copy).
	refPtr (const refPtr< T > &rhs, bool reuse)
	Copy/move construct. Optionally reusing pointer.
	refPtr (std::unique_ptr< T > &&rhs) noexcept
	Move construct from unique_ptr, transferring ownership.
	refPtr (const autoPtr< T > &)=delete
	No copy construct from autoPtr, also avoids implicit cast to object or pointer.
	refPtr (autoPtr< T > &&rhs) noexcept
	Move construct from autoPtr, transferring ownership.
	refPtr (const tmp< T > &rhs, bool reuse)
	Reference tmp contents or transfer ownership if requested/possible.
	refPtr (const tmp< T > &rhs)
	Reference the tmp contents.
	refPtr (tmp< T > &&rhs)
	Move construct from tmp, transfer ownership if possible.
	~refPtr () noexcept
	Destructor: deletes managed pointer.
bool	good () const noexcept
	True if pointer/reference is non-null.
bool	is_const () const noexcept
	If the stored/referenced content is const.
bool	is_pointer () const noexcept
	True if this is a managed pointer (not a reference).
bool	is_reference () const noexcept
	True if this is a reference (not a pointer).
bool	movable () const noexcept
	True if this is a non-null managed pointer.
T *	get () noexcept
	Return pointer without nullptr checking.
const T *	get () const noexcept
	Return const pointer without nullptr checking.
const T &	cref () const
	Return const reference to the object or to the contents of a (non-null) managed pointer.
T &	ref () const
	Return non-const reference to the contents of a non-null managed pointer.
T &	constCast () const
	Return non-const reference to the object or to the contents of a (non-null) managed pointer, with an additional const_cast.
refPtr< T >	shallowClone () const noexcept
	Return a shallow copy as a wrapped reference, preserving the const/non-const status.
T *	release () noexcept
	Release ownership and return the pointer. A no-op for reference objects (returns nullptr).
T *	ptr () const
	Return managed pointer for reuse, or clone() the object reference.
void	clear () const noexcept
	If object pointer points to valid object: delete object and set pointer to nullptr.
void	reset (T *p=nullptr) noexcept
	Delete managed pointer and set to new given pointer.
void	reset (refPtr< T > &&other) noexcept
	Clear existing and transfer ownership.
void	reset (const autoPtr< T > &)=delete
	No reset from autoPtr reference (potentially confusing).
void	reset (autoPtr< T > &&other) noexcept
	Clear existing and transfer ownership from autoPtr.
void	reset (std::unique_ptr< T > &&other)
	Clear existing and transfer ownership from unique_ptr.
void	reset (tmp< T > &rhs, bool reuse)
	Reference tmp contents or transfer pointer ownership if possible.
template<class... Args>
T &	emplace (Args &&... args)
	Reset with emplace construction. Return reference to the new content.
void	cref (const refPtr< T > &other) noexcept
	Clear existing and set (const) reference from other.
void	cref (const T &obj) noexcept
	Clear existing and set (const) reference.
void	cref (const T *p) noexcept
	Clear existing and set (const) reference to pointer content.
void	cref (const autoPtr< T > &)=delete
	Avoid inadvertent casting (to object or pointer).
void	cref (const tmp< T > &)=delete
	Avoid inadvertent casting (to object).
void	ref (T &obj) noexcept
	Clear existing and set (non-const) reference.
void	ref (T *p) noexcept
	Clear existing and set (non-const) reference to pointer content.
void	ref (const autoPtr< T > &)=delete
	Avoid inadvertent casting (to object or pointer).
void	ref (const tmp< T > &)=delete
	Avoid inadvertent casting (object).
void	swap (refPtr< T > &other) noexcept
	Swaps the managed object with other.
const T &	operator* () const
	Return const reference to the object.
T &	operator* ()
	Return reference to the managed object.
const T *	operator-> () const
	Dereferences (const) pointer to the managed object.
T *	operator-> ()
	Dereferences (non-const) pointer to the managed object.
const T &	operator() () const
	Return const reference to the object - same as cref() method.
	operator bool () const noexcept
	True if pointer/reference is non-null. Same as good().
	operator const T & () const
	Cast to underlying data type, using the cref() method.
void	operator= (const refPtr< T > &other)
	Transfer ownership of managed pointer.
void	operator= (refPtr< T > &&other) noexcept
	Clear existing and transfer ownership.
void	operator= (T *p)=delete
	No copy assignment from plain pointer (uncontrolled access).
void	operator= (std::nullptr_t) noexcept
	Reset via assignment from literal nullptr.
void	operator= (const autoPtr< T > &)=delete
	No copy assignment from autoPtr (can have unintended behaviour).
void	operator= (autoPtr< T > &&other) noexcept
	Transfer ownership by move assignment from autoPtr.
void	operator= (std::unique_ptr< T > &&other)
	Transfer ownership by move assignment from unique_ptr.
void	operator= (const tmp< T > &)=delete
	No copy assignment from tmp.
void	operator= (tmp< T > &&other)
	Move construct, transferring pointer ownership if possible.
	operator tmp< T > ()
	Conversion to tmp, releases pointer or shallow-copies reference.
bool	valid () const noexcept
	Identical to good(), or bool operator.
bool	empty () const noexcept
	Deprecated(2020-07) True if a null managed pointer.

Static Public Member Functions
template<class... Args>
static refPtr< T >	New (Args &&... args)
	Construct refPtr with forwarding arguments.
template<class U, class... Args>
static refPtr< T >	NewFrom (Args &&... args)
	Construct refPtr from derived type with forwarding arguments.
static word	typeName ()
	The type-name, constructed from type-name of T.

Detailed Description

template<class T>
class Foam::refPtr< T >

A class for managing references or pointers (no reference counting).

Source files

See also: Foam::autoPtr Foam::tmp

Definition at line 53 of file refPtr.H.

Member Typedef Documentation

◆ element_type

template<class T>

typedef T element_type

Type of object being managed or referenced.

Definition at line 86 of file refPtr.H.

◆ pointer

template<class T>

typedef T* pointer

Pointer to type of object being managed or referenced.

Definition at line 91 of file refPtr.H.

◆ refCount

template<class T>

typedef Foam::refCount::zero refCount

Null reference counter class.

Definition at line 97 of file refPtr.H.

Constructor & Destructor Documentation

◆ refPtr() [1/13]

template<class T>

refPtr ( )

inlineconstexprnoexcept

Construct with no managed pointer.

Definition at line 37 of file refPtrI.H.

References Foam::noexcept.

Referenced by cref(), New(), NewFrom(), operator=(), operator=(), ref(), refPtr(), refPtr(), refPtr(), refPtr(), refPtr(), refPtr(), refPtr(), refPtr(), refPtr(), reset(), shallowClone(), and swap().

Here is the caller graph for this function:

◆ refPtr() [2/13]

template<class T>

refPtr ( std::nullptr_t )

inlineconstexprnoexcept

Implicit construct from literal nullptr: no managed pointer.

Definition at line 45 of file refPtrI.H.

References Foam::noexcept.

◆ refPtr() [3/13]

template<class T>

refPtr ( T * p )

inlineexplicitconstexprnoexcept

Construct, taking ownership of the pointer.

Definition at line 53 of file refPtrI.H.

References Foam::noexcept, p, and Foam::T().

Here is the call graph for this function:

◆ refPtr() [4/13]

template<class T>

refPtr ( const T & obj )

inlineconstexprnoexcept

Implicit construct for a const reference to an object.

Definition at line 61 of file refPtrI.H.

References Foam::noexcept, and Foam::T().

Here is the call graph for this function:

◆ refPtr() [5/13]

template<class T>

refPtr ( refPtr< T > && rhs )

inlinenoexcept

Move construct, transferring ownership.

Definition at line 69 of file refPtrI.H.

References Foam::noexcept, refPtr(), and Foam::rhs().

Here is the call graph for this function:

◆ refPtr() [6/13]

template<class T>

refPtr ( const refPtr< T > & rhs )

inline

Copy construct (shallow copy).

Definition at line 80 of file refPtrI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, is_pointer(), refPtr(), Foam::rhs(), and typeName().

Here is the call graph for this function:

◆ refPtr() [7/13]

template<class T>

refPtr	(	const refPtr< T > &	rhs,
		bool	reuse )

inline

Copy/move construct. Optionally reusing pointer.

Definition at line 103 of file refPtrI.H.

References refPtr(), and Foam::rhs().

Here is the call graph for this function:

◆ refPtr() [8/13]

template<class T>

refPtr ( std::unique_ptr< T > && rhs )

inlineexplicitnoexcept

Move construct from unique_ptr, transferring ownership.

Definition at line 134 of file refPtrI.H.

References Foam::noexcept, refPtr(), and Foam::rhs().

Here is the call graph for this function:

◆ refPtr() [9/13]

template<class T>

refPtr ( const autoPtr< T > & )

delete

No copy construct from autoPtr, also avoids implicit cast to object or pointer.

References Foam::noexcept, refPtr(), Foam::rhs(), and Foam::T().

Here is the call graph for this function:

◆ refPtr() [10/13]

template<class T>

refPtr ( autoPtr< T > && rhs )

inlineexplicitnoexcept

Move construct from autoPtr, transferring ownership.

Definition at line 141 of file refPtrI.H.

References Foam::noexcept, refPtr(), and Foam::rhs().

Here is the call graph for this function:

◆ refPtr() [11/13]

template<class T>

refPtr	(	const tmp< T > &	rhs,
		bool	reuse )

inline

Reference tmp contents or transfer ownership if requested/possible.

Definition at line 148 of file refPtrI.H.

References refPtr(), reset(), Foam::rhs(), and Foam::T().

Here is the call graph for this function:

◆ refPtr() [12/13]

template<class T>

refPtr ( const tmp< T > & rhs )

inlineexplicit

Reference the tmp contents.

Definition at line 157 of file refPtrI.H.

References refPtr(), reset(), Foam::rhs(), and Foam::T().

Here is the call graph for this function:

◆ refPtr() [13/13]

template<class T>

refPtr ( tmp< T > && rhs )

inlineexplicit

Move construct from tmp, transfer ownership if possible.

Definition at line 166 of file refPtrI.H.

References refPtr(), reset(), Foam::rhs(), and Foam::T().

Here is the call graph for this function:

◆ ~refPtr()

template<class T>

~refPtr ( )

inlinenoexcept

Destructor: deletes managed pointer.

Definition at line 177 of file refPtrI.H.

References clear(), and Foam::noexcept.

Here is the call graph for this function:

Member Function Documentation

◆ New()

template<class T>

template<class... Args>

refPtr< T > New ( Args &&... args )

inlinestatic

Construct refPtr with forwarding arguments.

Parameters

args	list of arguments with which an instance of T will be constructed.

Note: Similar to std::make_shared, but the overload for array types is not disabled.

Definition at line 187 of file refPtr.H.

References args, New(), refPtr(), Foam::T(), and T.

Referenced by AMIInterpolation::calculate(), RASModelVariables::cloneRefPtr(), fvExprDriver::getTopoSetLabels(), fileOperation::lookupAndCacheProcessorsPath(), New(), and blockMesh::topology().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ NewFrom()

template<class T>

template<class U, class... Args>

refPtr< T > NewFrom ( Args &&... args )

inlinestatic

Construct refPtr from derived type with forwarding arguments.

Parameters

args	list of arguments with which an instance of U will be constructed.

Note: Similar to New but for derived types. Future check std::enable_if + std::is_convertible ?

Definition at line 202 of file refPtr.H.

References args, refPtr(), and U.

Here is the call graph for this function:

◆ typeName()

template<class T>

Foam::word typeName ( )

inlinestatic

The type-name, constructed from type-name of T.

Definition at line 28 of file refPtrI.H.

References name, and Foam::T().

Referenced by refPtr().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ good()

template<class T>

bool good ( ) const

inlinenoexcept

True if pointer/reference is non-null.

Definition at line 221 of file refPtr.H.

References Foam::noexcept.

Referenced by PrecisionAdaptor< Type, InputType, Container >::commit(), and fvExprDriver::getTopoSetLabels().

Here is the caller graph for this function:

◆ is_const()

template<class T>

bool is_const ( ) const

inlinenoexcept

If the stored/referenced content is const.

Definition at line 186 of file refPtrI.H.

References Foam::noexcept.

Referenced by operator*(), operator->(), and shallowClone().

Here is the caller graph for this function:

◆ is_pointer()

template<class T>

bool is_pointer ( ) const

inlinenoexcept

True if this is a managed pointer (not a reference).

Definition at line 193 of file refPtrI.H.

References Foam::noexcept.

Referenced by clear(), cref(), movable(), operator tmp< T >(), operator=(), refPtr(), release(), and regIOobject::store().

Here is the caller graph for this function:

◆ is_reference()

template<class T>

bool is_reference ( ) const

inlinenoexcept

True if this is a reference (not a pointer).

Definition at line 201 of file refPtrI.H.

References Foam::noexcept.

◆ movable()

template<class T>

bool movable ( ) const

inlinenoexcept

True if this is a non-null managed pointer.

Definition at line 209 of file refPtrI.H.

References is_pointer(), and Foam::noexcept.

Here is the call graph for this function:

◆ get() [1/2]

template<class T>

T * get ( )

inlinenoexcept

Return pointer without nullptr checking.

Definition at line 249 of file refPtr.H.

References get(), Foam::noexcept, and Foam::T().

Referenced by fileOperation::fileHandler(), get(), and regIOobject::store().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get() [2/2]

template<class T>

const T * get ( ) const

inlinenoexcept

Return const pointer without nullptr checking.

Definition at line 254 of file refPtr.H.

References Foam::noexcept, and Foam::T().

Here is the call graph for this function:

◆ cref() [1/6]

template<class T>

const T & cref ( ) const

inline

Return const reference to the object or to the contents of a (non-null) managed pointer.

Fatal for a null managed pointer

Definition at line 216 of file refPtrI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, is_pointer(), and Foam::T().

Referenced by constCast(), parseDriver::getField(), fvExprDriver::getOrReadFieldImpl(), fvExprDriver::getTopoSetLabels(), fvExprDriver::getVariable(), parseDriver::getVariableIfAvailable(), streamLineBase::initInterpolations(), Function1< Type >::New(), refPtr< Field< InputType > >::operator const Field< InputType > &(), operator tmp< T >(), operator()(), GAMGPreconditioner::precondition(), GAMGAgglomeration::procAgglomerateLduAddressing(), Foam::shallowCloneFunctions(), regIOobject::store(), streamLine::track(), and wallBoundedStreamLine::track().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ref() [1/5]

template<class T>

T & ref ( ) const

inline

Return non-const reference to the contents of a non-null managed pointer.

Fatal for a null managed pointer or if the object is const.

Definition at line 230 of file refPtrI.H.

References Foam::T().

Referenced by kahipDecomp::decomposeSerial(), metisDecomp::decomposeSerial(), scotchDecomp::decomposeSerial(), primitiveMeshTools::makeCellCentresAndVols(), cyclicPolyPatch::mapCollocatedFaces(), mappedPolyPatch::mapCollocatedFaces(), mappedWallPolyPatch::mapCollocatedFaces(), faMatrix< scalar >::residual(), fvMatrix< scalar >::residual(), lduMatrix::solver::scalarSolve(), fvMesh::setPhi(), faMatrix< Type >::solve(), FPCG::solve(), GAMGSolver::solve(), PBiCG::solve(), PBiCGStab::solve(), PCG::solve(), PPCG::solve(), PPCR::solve(), smoothSolver::solve(), fvMatrix< Type >::solveSegregated(), and primitiveMeshTools::updateCellCentresAndVols().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ constCast()

template<class T>

T & constCast ( ) const

inline

Return non-const reference to the object or to the contents of a (non-null) managed pointer, with an additional const_cast.

Fatal for a null managed pointer.

Definition at line 278 of file refPtr.H.

References cref(), and Foam::T().

Referenced by kahipDecomp::decomposeSerial(), metisDecomp::decomposeSerial(), and meshRefinement::findRegions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ shallowClone()

template<class T>

Foam::refPtr< T > shallowClone ( ) const

inlinenoexcept

Return a shallow copy as a wrapped reference, preserving the const/non-const status.

Definition at line 251 of file refPtrI.H.

References is_const(), Foam::noexcept, and refPtr().

Here is the call graph for this function:

◆ release()

template<class T>

T * release ( )

inlinenoexcept

Release ownership and return the pointer. A no-op for reference objects (returns nullptr).

Remarks: Method naming consistent with std::unique_ptr

Definition at line 266 of file refPtrI.H.

References is_pointer(), Foam::noexcept, and Foam::T().

Referenced by regIOobject::store().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ptr()

template<class T>

T * ptr ( ) const

inline

Return managed pointer for reuse, or clone() the object reference.

Remarks: Method naming consistent with Foam::tmp

Definition at line 280 of file refPtrI.H.

References Foam::T().

Referenced by operator tmp< T >(), PtrDynList< T, SizeMin >::push_back(), PtrList< T >::push_back(), HashPtrTable< T, Key, Hash >::set(), PtrDynList< T, SizeMin >::set(), and PtrList< T >::set().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clear()

template<class T>

void clear ( ) const

inlinenoexcept

If object pointer points to valid object: delete object and set pointer to nullptr.

Definition at line 303 of file refPtrI.H.

References is_pointer(), and Foam::noexcept.

Referenced by kahipDecomp::decomposeSerial(), metisDecomp::decomposeSerial(), and scotchDecomp::decomposeSerial().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reset() [1/6]

template<class T>

void reset ( T * p = nullptr )

inlinenoexcept

Delete managed pointer and set to new given pointer.

Definition at line 314 of file refPtrI.H.

References clear(), p, and Foam::T().

Referenced by fileOperation::fileHandler(), fvExprDriver::getTopoSetLabels(), streamLineBase::initInterpolations(), operator=(), operator=(), operator=(), operator=(), refPtr(), refPtr(), refPtr(), reset(), reset(), and ISQP::ShermanMorrisonPrecon().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reset() [2/6]

template<class T>

void reset ( refPtr< T > && other )

inlinenoexcept

Clear existing and transfer ownership.

Definition at line 323 of file refPtrI.H.

References clear(), and refPtr().

Here is the call graph for this function:

◆ reset() [3/6]

template<class T>

void reset ( const autoPtr< T > & )

delete

No reset from autoPtr reference (potentially confusing).

References reset(), and Foam::T().

Here is the call graph for this function:

◆ reset() [4/6]

template<class T>

void reset ( autoPtr< T > && other )

inlinenoexcept

Clear existing and transfer ownership from autoPtr.

Definition at line 328 of file refPtr.H.

References Foam::noexcept, reset(), reset(), and Foam::T().

Referenced by reset().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reset() [5/6]

template<class T>

void reset ( std::unique_ptr< T > && other )

inline

Clear existing and transfer ownership from unique_ptr.

Definition at line 333 of file refPtr.H.

References reset().

Referenced by reset().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reset() [6/6]

template<class T>

void reset	(	tmp< T > &	rhs,
		bool	reuse )

inline

Reference tmp contents or transfer pointer ownership if possible.

Definition at line 341 of file refPtrI.H.

References tmp< T >::get().

Here is the call graph for this function:

◆ emplace()

template<class T>

template<class... Args>

T & emplace ( Args &&... args )

inline

Reset with emplace construction. Return reference to the new content.

Definition at line 369 of file refPtrI.H.

References args, clear(), Foam::T(), and T.

Here is the call graph for this function:

◆ cref() [2/6]

template<class T>

void cref ( const refPtr< T > & other )

inlinenoexcept

Clear existing and set (const) reference from other.

Definition at line 379 of file refPtrI.H.

References clear(), and refPtr().

Here is the call graph for this function:

◆ cref() [3/6]

template<class T>

void cref ( const T & obj )

inlinenoexcept

Clear existing and set (const) reference.

Definition at line 394 of file refPtrI.H.

References clear(), and Foam::T().

Here is the call graph for this function:

◆ cref() [4/6]

template<class T>

void cref ( const T * p )

inlinenoexcept

Clear existing and set (const) reference to pointer content.

The pointer can be null, which is handled like a clear().

Definition at line 403 of file refPtrI.H.

References clear(), p, and Foam::T().

Here is the call graph for this function:

◆ cref() [5/6]

template<class T>

void cref ( const autoPtr< T > & )

delete

Avoid inadvertent casting (to object or pointer).

◆ cref() [6/6]

template<class T>

void cref ( const tmp< T > & )

delete

Avoid inadvertent casting (to object).

References p, and Foam::T().

Here is the call graph for this function:

◆ ref() [2/5]

template<class T>

void ref ( T & obj )

inlinenoexcept

Clear existing and set (non-const) reference.

Definition at line 412 of file refPtrI.H.

References clear(), and Foam::T().

Here is the call graph for this function:

◆ ref() [3/5]

template<class T>

void ref ( T * p )

inlinenoexcept

Clear existing and set (non-const) reference to pointer content.

The pointer can be null, which is handled like a clear().

Definition at line 421 of file refPtrI.H.

References p, and Foam::T().

Here is the call graph for this function:

◆ ref() [4/5]

template<class T>

void ref ( const autoPtr< T > & )

delete

Avoid inadvertent casting (to object or pointer).

◆ ref() [5/5]

template<class T>

void ref ( const tmp< T > & )

delete

Avoid inadvertent casting (object).

References refPtr(), and Foam::T().

Here is the call graph for this function:

◆ swap()

template<class T>

void swap ( refPtr< T > & other )

inlinenoexcept

Swaps the managed object with other.

Definition at line 430 of file refPtrI.H.

References p, refPtr(), and Foam::T().

Referenced by fileOperation::fileHandler(), and fileOperation::fileHandler().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator*() [1/2]

template<class T>

const T & operator* ( ) const

inline

Return const reference to the object.

Fatal if nothing is managed

Definition at line 447 of file refPtrI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, and Foam::T().

Here is the call graph for this function:

◆ operator*() [2/2]

template<class T>

T & operator* ( )

inline

Return reference to the managed object.

Fatal if nothing is managed or if the object is const.

Definition at line 460 of file refPtrI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, is_const(), and Foam::T().

Here is the call graph for this function:

◆ operator->() [1/2]

template<class T>

const T * operator-> ( ) const

inline

Dereferences (const) pointer to the managed object.

Fatal if nothing is managed.

Definition at line 481 of file refPtrI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, and Foam::T().

Here is the call graph for this function:

◆ operator->() [2/2]

template<class T>

T * operator-> ( )

inline

Dereferences (non-const) pointer to the managed object.

Fatal if nothing is managed or if the object is const.

Definition at line 495 of file refPtrI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, is_const(), and Foam::T().

Here is the call graph for this function:

◆ operator()()

template<class T>

const T & operator() ( ) const

inline

Return const reference to the object - same as cref() method.

Definition at line 435 of file refPtr.H.

References cref(), and Foam::T().

Here is the call graph for this function:

◆ operator bool()

template<class T>

operator bool ( ) const

inlineexplicitnoexcept

True if pointer/reference is non-null. Same as good().

Definition at line 443 of file refPtr.H.

References Foam::noexcept.

◆ operator const T &()

template<class T>

operator const T & ( ) const

inline

Cast to underlying data type, using the cref() method.

Definition at line 448 of file refPtr.H.

◆ operator=() [1/9]

template<class T>

void operator= ( const refPtr< T > & other )

inline

Transfer ownership of managed pointer.

Fatal for a null managed pointer or if the object is const.

Definition at line 516 of file refPtrI.H.

References Foam::abort(), clear(), Foam::FatalError, FatalErrorInFunction, Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, is_pointer(), name, refPtr(), and Foam::T().

Here is the call graph for this function:

◆ operator=() [2/9]

template<class T>

void operator= ( refPtr< T > && other )

inlinenoexcept

Clear existing and transfer ownership.

Definition at line 463 of file refPtr.H.

References refPtr(), and reset().

Here is the call graph for this function:

◆ operator=() [3/9]

template<class T>

void operator= ( T * p )

delete

No copy assignment from plain pointer (uncontrolled access).

References p, and Foam::T().

Here is the call graph for this function:

◆ operator=() [4/9]

template<class T>

void operator= ( std::nullptr_t )

inlinenoexcept

Reset via assignment from literal nullptr.

Definition at line 473 of file refPtr.H.

References reset().

Here is the call graph for this function:

◆ operator=() [5/9]

template<class T>

void operator= ( const autoPtr< T > & )

delete

No copy assignment from autoPtr (can have unintended behaviour).

◆ operator=() [6/9]

template<class T>

void operator= ( autoPtr< T > && other )

inlinenoexcept

Transfer ownership by move assignment from autoPtr.

Definition at line 483 of file refPtr.H.

References reset().

Here is the call graph for this function:

◆ operator=() [7/9]

template<class T>

void operator= ( std::unique_ptr< T > && other )

inline

Transfer ownership by move assignment from unique_ptr.

Definition at line 488 of file refPtr.H.

References reset().

Here is the call graph for this function:

◆ operator=() [8/9]

template<class T>

void operator= ( const tmp< T > & )

delete

No copy assignment from tmp.

◆ operator=() [9/9]

template<class T>

void operator= ( tmp< T > && other )

inline

Move construct, transferring pointer ownership if possible.

Definition at line 553 of file refPtrI.H.

References reset().

Here is the call graph for this function:

◆ operator tmp< T >()

template<class T>

operator tmp< T > ( )

inline

Conversion to tmp, releases pointer or shallow-copies reference.

Definition at line 560 of file refPtrI.H.

References cref(), is_pointer(), and ptr().

Here is the call graph for this function:

◆ valid()

template<class T>

bool valid ( ) const

inlinenoexcept

Identical to good(), or bool operator.

Definition at line 512 of file refPtr.H.

References Foam::noexcept.

Referenced by fvExprDriver::getOrReadFieldImpl(), fvExprDriver::getVariable(), and parseDriver::getVariableIfAvailable().

Here is the caller graph for this function:

◆ empty()

template<class T>

bool empty ( ) const

inlinenoexcept

Deprecated(2020-07) True if a null managed pointer.

Deprecated: (2020-07) - use bool operator

Definition at line 521 of file refPtr.H.

References empty(), and Foam::noexcept.

Referenced by empty().

Here is the call graph for this function:

Here is the caller graph for this function:

The documentation for this class was generated from the following files:

src/OpenFOAM/containers/HashTables/HashPtrTable/HashPtrTable.H
src/OpenFOAM/memory/refPtr/refPtr.H
src/OpenFOAM/memory/refPtr/refPtrI.H

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ element_type

◆ pointer

◆ refCount

Constructor & Destructor Documentation

◆ refPtr() [1/13]

◆ refPtr() [2/13]

◆ refPtr() [3/13]

◆ refPtr() [4/13]

◆ refPtr() [5/13]

◆ refPtr() [6/13]

◆ refPtr() [7/13]

◆ refPtr() [8/13]

◆ refPtr() [9/13]

◆ refPtr() [10/13]

◆ refPtr() [11/13]

◆ refPtr() [12/13]

◆ refPtr() [13/13]

◆ ~refPtr()

Member Function Documentation

◆ New()

◆ NewFrom()

◆ typeName()

◆ good()

◆ is_const()

◆ is_pointer()

◆ is_reference()

◆ movable()

◆ get() [1/2]

◆ get() [2/2]

◆ cref() [1/6]

◆ ref() [1/5]

◆ constCast()

◆ shallowClone()

◆ release()

◆ ptr()

◆ clear()

◆ reset() [1/6]

◆ reset() [2/6]

◆ reset() [3/6]

◆ reset() [4/6]

◆ reset() [5/6]

◆ reset() [6/6]

◆ emplace()

◆ cref() [2/6]

◆ cref() [3/6]

◆ cref() [4/6]

◆ cref() [5/6]

◆ cref() [6/6]

◆ ref() [2/5]

◆ ref() [3/5]

◆ ref() [4/5]

◆ ref() [5/5]

◆ swap()

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator->() [1/2]

◆ operator->() [2/2]

◆ operator()()

◆ operator bool()

◆ operator const T &()

◆ operator=() [1/9]

◆ operator=() [2/9]

◆ operator=() [3/9]

◆ operator=() [4/9]

◆ operator=() [5/9]

◆ operator=() [6/9]

◆ operator=() [7/9]

◆ operator=() [8/9]

◆ operator=() [9/9]

◆ operator tmp< T >()

◆ valid()

◆ empty()