A dynamically resizable PtrList with allocation management. More...

Inheritance diagram for PtrDynList< T, SizeMin >:

Public Member Functions
constexpr	PtrDynList () noexcept
	Construct null. More...

	PtrDynList (const label len)
	Construct with given capacity. More...

	PtrDynList (const PtrDynList< T, SizeMin > &list)
	Copy construct using 'clone()' method on each element. More...

	PtrDynList (PtrDynList< T, SizeMin > &&list)
	Move construct. More...

	PtrDynList (UList< T * > &list)
	Take ownership of pointers in the list, set old pointers to null. More...

	~PtrDynList ()=default
	Destructor. More...

label	capacity () const noexcept
	Size of the underlying storage. More...

const T *	get (const label i) const
	Return const pointer to element (can be nullptr),. More...

const T *	set (const label i) const
	Return const pointer to element (if set) or nullptr,. More...

void	setCapacity (const label nElem)
	Alter the size of the underlying storage. More...

void	resize (const label newLen)
	Alter the addressed list size. More...

void	setSize (const label newLen)
	Same as resize() More...

void	reserve (const label nElem)
	Reserve allocation space for at least this size. More...

void	clear ()
	Clear the addressed list, i.e. set the size to zero. More...

void	clearStorage ()
	Clear the list and delete storage. More...

label	expandStorage ()
	Expand the addressable size to fit the allocated capacity. More...

void	shrink ()
	Shrink the allocated space to the number of elements used. More...

label	squeezeNull ()

template<class... Args>
void	emplace_append (Args &&... args)
	Construct and append an element to the end of the list. More...

void	append (T *ptr)
	Append an element to the end of the list. More...

void	append (autoPtr< T > &ptr)
	Move append an element to the end of the list. More...

void	append (autoPtr< T > &&ptr)
	Move append an element to the end of the list. More...

void	append (std::unique_ptr< T > &&ptr)
	Move append an element to the end of the list. More...

void	append (const refPtr< T > &ptr)
	Move or clone append a tmp to the end of the list. More...

void	append (const tmp< T > &ptr)
	Move or clone append a tmp to the end of the list. More...

void	append (PtrList< T > &&other)
	Move append another list to the end of this list. More...

template<int AnySizeMin>
void	append (PtrDynList< T, AnySizeMin > &&other)
	Move append another list to the end of this list. More...

autoPtr< T >	remove ()
	Remove and return the top element. More...

template<class... Args>
autoPtr< T >	emplace (const label i, Args &&... args)
	Construct and set an element. More...

autoPtr< T >	set (const label i, T *ptr)
	Set element to given pointer and return old element (can be null) More...

autoPtr< T >	set (const label i, autoPtr< T > &ptr)
	Set element to given autoPtr and return old element. More...

autoPtr< T >	set (const label i, autoPtr< T > &&ptr)
	Set element to given autoPtr and return old element. More...

autoPtr< T >	set (const label i, std::unique_ptr< T > &&ptr)
	Set element to given pointer and return old element. More...

autoPtr< T >	set (const label i, const refPtr< T > &ptr)
	Set element to given refPtr and return old element. More...

autoPtr< T >	set (const label i, const tmp< T > &ptr)
	Set element to given tmp and return old element. More...

void	reorder (const labelUList &oldToNew)
	Reorder elements. Reordering must be unique (ie, shuffle). More...

void	operator= (const PtrList< T > &list)
	Copy (clone) assignment. More...

void	operator= (const PtrDynList< T, SizeMin > &list)
	Copy (clone) assignment. More...

template<int AnySizeMin>
void	operator= (const PtrDynList< T, AnySizeMin > &list)
	Copy (clone) assignment with different sizing parameters. More...

void	operator= (PtrList< T > &&list)
	Move assignment. More...

void	operator= (PtrDynList< T, SizeMin > &&list)
	Move assignment. More...

template<int AnySizeMin>
void	operator= (PtrDynList< T, AnySizeMin > &&list)
	Move assignment with different sizing parameters. More...

template<class... Args>
Foam::autoPtr< T >	emplace (const label i, Args &&... args)

Detailed Description

template<class T, int SizeMin = 64>
class Foam::PtrDynList< T, SizeMin >

A dynamically resizable PtrList with allocation management.

See also: Foam::UPtrList Foam::PtrList

Source files

Definition at line 54 of file PtrDynList.H.

Constructor & Destructor Documentation

◆ PtrDynList() [1/5]

constexpr PtrDynList ( )

inlineconstexprnoexcept

Construct null.

Definition at line 44 of file PtrDynListI.H.

◆ PtrDynList() [2/5]

PtrDynList ( const label len )

inlineexplicit

Construct with given capacity.

Definition at line 52 of file PtrDynListI.H.

◆ PtrDynList() [3/5]

PtrDynList ( const PtrDynList< T, SizeMin > & list )

inline

Copy construct using 'clone()' method on each element.

Definition at line 63 of file PtrDynListI.H.

◆ PtrDynList() [4/5]

PtrDynList ( PtrDynList< T, SizeMin > && list )

inline

Move construct.

Definition at line 74 of file PtrDynListI.H.

◆ PtrDynList() [5/5]

PtrDynList ( UList< T * > & list )

inlineexplicit

Take ownership of pointers in the list, set old pointers to null.

Definition at line 86 of file PtrDynListI.H.

◆ ~PtrDynList()

~PtrDynList ( )

default

Destructor.

Member Function Documentation

◆ capacity()

Foam::label capacity ( ) const

inlinenoexcept

Size of the underlying storage.

Definition at line 96 of file PtrDynListI.H.

Referenced by PtrDynList< Foam::profilingInformation >::operator=().

Here is the caller graph for this function:

◆ get()

const T * get ( const label i ) const

inline

Return const pointer to element (can be nullptr),.

with bounds checking.

Definition at line 103 of file PtrDynListI.H.

◆ set() [1/7]

const T* set ( const label i ) const

inline

Return const pointer to element (if set) or nullptr,.

with bounds checking. The return value can be tested as a bool.

Definition at line 117 of file PtrDynList.H.

◆ setCapacity()

void setCapacity ( const label nElem )

inline

Alter the size of the underlying storage.

Definition at line 110 of file PtrDynListI.H.

◆ resize()

void resize ( const label newLen )

inline

Alter the addressed list size.

Definition at line 144 of file PtrDynListI.H.

◆ setSize()

void setSize ( const label newLen )

inline

Same as resize()

Definition at line 172 of file PtrDynListI.H.

◆ reserve()

void reserve ( const label nElem )

inline

Reserve allocation space for at least this size.

Never shrinks the allocated size, use setCapacity() for that.

Definition at line 127 of file PtrDynListI.H.

◆ clear()

void clear ( )

inline

Clear the addressed list, i.e. set the size to zero.

Allocated size does not change

Definition at line 179 of file PtrDynListI.H.

◆ clearStorage()

void clearStorage ( )

inline

Clear the list and delete storage.

Definition at line 187 of file PtrDynListI.H.

Referenced by PtrDynList< Foam::profilingInformation >::operator=(), and PtrDynList< Foam::profilingInformation >::PtrDynList().

Here is the caller graph for this function:

◆ expandStorage()

Foam::label expandStorage ( )

inline

Expand the addressable size to fit the allocated capacity.

Returns the previous addressable size.

Definition at line 195 of file PtrDynListI.H.

◆ shrink()

void shrink ( )

inline

Shrink the allocated space to the number of elements used.

Definition at line 207 of file PtrDynListI.H.

◆ squeezeNull()

Foam::label squeezeNull ( )

inline

Squeeze out intermediate nullptr entries in the list of pointers and adjust the addressable size accordingly.

Returns: the number of non-null entries

Definition at line 224 of file PtrDynListI.H.

◆ emplace_append()

void emplace_append ( Args &&... args )

inline

Construct and append an element to the end of the list.

Definition at line 234 of file PtrDynListI.H.

◆ append() [1/8]

void append ( T * ptr )

inline

Append an element to the end of the list.

Definition at line 241 of file PtrDynListI.H.

◆ append() [2/8]

void append ( autoPtr< T > & ptr )

inline

Move append an element to the end of the list.

Definition at line 250 of file PtrDynListI.H.

◆ append() [3/8]

void append ( autoPtr< T > && ptr )

inline

Move append an element to the end of the list.

Definition at line 257 of file PtrDynListI.H.

◆ append() [4/8]

void append ( std::unique_ptr< T > && ptr )

inline

Move append an element to the end of the list.

Definition at line 264 of file PtrDynListI.H.

◆ append() [5/8]

void append ( const refPtr< T > & ptr )

inline

Move or clone append a tmp to the end of the list.

Definition at line 271 of file PtrDynListI.H.

◆ append() [6/8]

void append ( const tmp< T > & ptr )

inline

Move or clone append a tmp to the end of the list.

Definition at line 278 of file PtrDynListI.H.

◆ append() [7/8]

void append ( PtrList< T > && other )

inline

Move append another list to the end of this list.

Definition at line 285 of file PtrDynListI.H.

◆ append() [8/8]

void append ( PtrDynList< T, AnySizeMin > && other )

inline

Move append another list to the end of this list.

Definition at line 304 of file PtrDynListI.H.

◆ remove()

Foam::autoPtr< T > remove ( )

inline

Remove and return the top element.

Definition at line 323 of file PtrDynListI.H.

◆ emplace() [1/2]

autoPtr<T> emplace	(	const label	i,
		Args &&...	args
	)

inline

Construct and set an element.

◆ set() [2/7]

Foam::autoPtr< T > set	(	const label	i,
		T *	ptr
	)

inline

Set element to given pointer and return old element (can be null)

Definition at line 355 of file PtrDynListI.H.

◆ set() [3/7]

Foam::autoPtr< T > set	(	const label	i,
		autoPtr< T > &	ptr
	)

inline

Set element to given autoPtr and return old element.

Definition at line 371 of file PtrDynListI.H.

◆ set() [4/7]

Foam::autoPtr< T > set	(	const label	i,
		autoPtr< T > &&	ptr
	)

inline

Set element to given autoPtr and return old element.

Definition at line 382 of file PtrDynListI.H.

◆ set() [5/7]

Foam::autoPtr< T > set	(	const label	i,
		std::unique_ptr< T > &&	ptr
	)

inline

Set element to given pointer and return old element.

Definition at line 393 of file PtrDynListI.H.

◆ set() [6/7]

Foam::autoPtr< T > set	(	const label	i,
		const refPtr< T > &	ptr
	)

inline

Set element to given refPtr and return old element.

Definition at line 404 of file PtrDynListI.H.

◆ set() [7/7]

Foam::autoPtr< T > set	(	const label	i,
		const tmp< T > &	ptr
	)

inline

Set element to given tmp and return old element.

Definition at line 415 of file PtrDynListI.H.

◆ reorder()

void reorder ( const labelUList & oldToNew )

inline

Reorder elements. Reordering must be unique (ie, shuffle).

Definition at line 425 of file PtrDynListI.H.

◆ operator=() [1/6]

void operator= ( const PtrList< T > & list )

inline

Copy (clone) assignment.

Definition at line 437 of file PtrDynListI.H.

◆ operator=() [2/6]

void operator= ( const PtrDynList< T, SizeMin > & list )

inline

Copy (clone) assignment.

Definition at line 453 of file PtrDynListI.H.

◆ operator=() [3/6]

void operator= ( const PtrDynList< T, AnySizeMin > & list )

inline

Copy (clone) assignment with different sizing parameters.

Definition at line 470 of file PtrDynListI.H.

◆ operator=() [4/6]

void operator= ( PtrList< T > && list )

inline

Move assignment.

Definition at line 487 of file PtrDynListI.H.

◆ operator=() [5/6]

void operator= ( PtrDynList< T, SizeMin > && list )

inline

Move assignment.

Definition at line 504 of file PtrDynListI.H.

◆ operator=() [6/6]

void operator= ( PtrDynList< T, AnySizeMin > && list )

inline

Move assignment with different sizing parameters.

Definition at line 522 of file PtrDynListI.H.

◆ emplace() [2/2]

Foam::autoPtr<T> emplace	(	const label	i,
		Args &&...	args
	)

inline

Definition at line 344 of file PtrDynListI.H.

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

src/OpenFOAM/containers/PtrLists/PtrDynList/PtrDynList.H
src/OpenFOAM/containers/PtrLists/PtrDynList/PtrDynListI.H

Public Member Functions

Detailed Description

template<class T, int SizeMin = 64> class Foam::PtrDynList< T, SizeMin >

Constructor & Destructor Documentation

◆ PtrDynList() [1/5]

◆ PtrDynList() [2/5]

◆ PtrDynList() [3/5]

◆ PtrDynList() [4/5]

◆ PtrDynList() [5/5]

◆ ~PtrDynList()

Member Function Documentation

◆ capacity()

◆ get()

◆ set() [1/7]

◆ setCapacity()

◆ resize()

◆ setSize()

◆ reserve()

◆ clear()

◆ clearStorage()

◆ expandStorage()

◆ shrink()

◆ squeezeNull()

◆ emplace_append()

◆ append() [1/8]

◆ append() [2/8]

◆ append() [3/8]

◆ append() [4/8]

◆ append() [5/8]

◆ append() [6/8]

◆ append() [7/8]

◆ append() [8/8]

◆ remove()

◆ emplace() [1/2]

◆ set() [2/7]

◆ set() [3/7]

◆ set() [4/7]

◆ set() [5/7]

◆ set() [6/7]

◆ set() [7/7]

◆ reorder()

◆ operator=() [1/6]

◆ operator=() [2/6]

◆ operator=() [3/6]

◆ operator=() [4/6]

◆ operator=() [5/6]

◆ operator=() [6/6]

◆ emplace() [2/2]

template<class T, int SizeMin = 64>
class Foam::PtrDynList< T, SizeMin >