PtrListDetail< T > Class Template Reference

A rudimentary list of pointers used for PtrList, UPtrList, etc. This class is considered implementation detail and should not normally be used other than by OpenFOAM container classes. More...

Inherits List< T * >.

Collaboration diagram for PtrListDetail< T >:
[legend]

Public Member Functions

constexpr PtrListDetail () noexcept
 Default construct. More...
 
 PtrListDetail (const label len)
 Construct with specified size, each element initialized to nullptr. More...
 
 PtrListDetail (const UList< T * > &list)
 Copy a list of pointers. More...
 
 PtrListDetail (const PtrListDetail< T > &list)
 Copy construct (shallow copies addresses) More...
 
 PtrListDetail (PtrListDetail< T > &&list)
 Move construct. More...
 
 PtrListDetail (PtrListDetail< T > &list, bool reuse)
 Copy or move (reuse) construct as specified. More...
 
label count () const
 Return the count of non-nullptr entries. More...
 
label findNull () const
 Locate the first null entry, -1 if there are none (or empty list) More...
 
void checkNonNull () const
 FatalError if any null exists in the list. More...
 
void setNull ()
 Assign all pointers to nullptr, without deleting. More...
 
void free ()
 Delete the allocated entries, but retain the list size. More...
 
template<class... Args>
PtrListDetail< Tclone (Args &&... args) const
 Make a copy by cloning each of the list pointers. More...
 
void resize (const label newLen)
 Reset size of list. More...
 
void setAddressableSize (const label n) noexcept
 Set addressed size to be inconsistent with allocated storage. More...
 
Ostreamwrite (Ostream &os, const bool trimNull=false) const
 Write output, optionally silently trimming nullptrs. More...
 
void operator= (const PtrListDetail< T > &list)
 Copy assignment (shallow copies addresses) More...
 
void operator= (PtrListDetail< T > &&list)
 Move assignment. More...
 
void setSize (const label)=delete
 
void setSize (const label, const T &)=delete
 
void setSize (const label, const T *)=delete
 
void resize_nocopy (const label)=delete
 
template<class... Args>
Foam::Detail::PtrListDetail< Tclone (Args &&... args) const
 
- Public Member Functions inherited from List< T * >
constexpr List () noexcept
 Default construct. More...
 
 List (const label len)
 Construct with given size. More...
 
 List (const label len, const T * &val)
 Construct with given size and value for all elements. More...
 
 List (const label len, const Foam::zero)
 Construct with given size initializing all elements to zero. More...
 
 List (const Foam::one, const T * &val)
 Construct with length=1, copying the value as the only content. More...
 
 List (const Foam::one, T * &&val)
 Construct with length=1, moving the value as the only content. More...
 
 List (const Foam::one, const Foam::zero)
 Construct with length=1, initializing content to zero. More...
 
 List (const List< T * > &a)
 Copy construct from list. More...
 
 List (const UList< T * > &a)
 Copy construct contents from list. More...
 
 List (List< T * > &a, bool reuse)
 Construct as copy or re-use as specified. More...
 
 List (const UList< T * > &list, const labelUList &indices)
 Copy construct subset of list. More...
 
 List (const UList< T * > &list, const FixedList< label, N > &indices)
 Copy construct subset of list. More...
 
 List (const FixedList< T *, N > &list)
 Construct as copy of FixedList<T, N> More...
 
 List (const PtrList< T * > &list)
 Construct as copy of PtrList<T> More...
 
 List (const SLList< T * > &list)
 Construct as copy of SLList<T> More...
 
 List (const IndirectListBase< T *, Addr > &list)
 Construct as copy of IndirectList contents. More...
 
 List (std::initializer_list< T * > list)
 Construct from an initializer list. More...
 
 List (List< T * > &&list)
 Move construct from List. More...
 
 List (DynamicList< T *, SizeMin > &&list)
 Move construct from DynamicList. More...
 
 List (SLList< T * > &&list)
 Move construct from SLList. More...
 
 List (Istream &is)
 Construct from Istream. More...
 
autoPtr< List< T * > > clone () const
 Clone. More...
 
 ~List ()
 Destructor. More...
 
void clear ()
 Clear the list, i.e. set size to zero. More...
 
void resize (const label len)
 Adjust allocated size of list. More...
 
void resize (const label len, const T * &val)
 Adjust allocated size of list and set val for new elements. More...
 
void resize (const label newLen)
 
void resize_nocopy (const label len)
 Adjust allocated size of list without necessarily. More...
 
void setSize (const label n)
 Alias for resize() More...
 
void setSize (const label n, const T * &val)
 Alias for resize() More...
 
void append (const T * &val)
 Append an element at the end of the list. More...
 
void append (T * &&val)
 Move append an element at the end of the list. More...
 
void append (const UList< T * > &list)
 Append a List to the end of this list. More...
 
void append (const IndirectListBase< T *, Addr > &list)
 Append IndirectList contents at the end of this list. More...
 
label appendUniq (const T * &val)
 Append an element if not already in the list. More...
 
void transfer (List< T * > &list)
 
void transfer (DynamicList< T *, SizeMin > &list)
 
T * & newElmt (const label i)
 
void operator= (const UList< T * > &a)
 Assignment to UList operator. Takes linear time. More...
 
void operator= (const List< T * > &list)
 Assignment operator. Takes linear time. More...
 
void operator= (const SLList< T * > &list)
 Assignment to SLList operator. Takes linear time. More...
 
void operator= (const IndirectListBase< T *, Addr > &list)
 Assignment from IndirectList. Takes linear time. More...
 
void operator= (const FixedList< T *, N > &list)
 Copy assignment from FixedList. More...
 
void operator= (std::initializer_list< T * > list)
 Assignment to an initializer list. More...
 
void operator= (const T * &val)
 Assignment of all entries to the given value. More...
 
void operator= (const Foam::zero)
 Assignment of all entries to zero. More...
 
void operator= (List< T * > &&list)
 Move assignment. Takes constant time. More...
 
void operator= (DynamicList< T *, SizeMin > &&list)
 Move assignment. Takes constant time. More...
 
void operator= (SLList< T * > &&list)
 Move assignment. Takes constant time. More...
 
IstreamreadList (Istream &is)
 Read List from Istream, discarding contents of existing List. More...
 
IstreamreadList (Istream &is)
 
IstreamreadList (Istream &is)
 
void shallowCopy (const UList< T * > &)=delete
 No shallowCopy permitted. More...
 
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type set (const label i, bool val=true)
 A bitSet::set() method for a list of bool. More...
 
- Public Member Functions inherited from UList< T >
 UList (const UList< T > &)=default
 Copy construct. More...
 
constexpr UList () noexcept
 Default construct, zero-sized and nullptr. More...
 
 UList (T *__restrict__ v, const label len) noexcept
 Construct from components. More...
 
label fcIndex (const label i) const noexcept
 
label rcIndex (const label i) const noexcept
 
const TfcValue (const label i) const
 Return forward circular value (ie, next value in the list) More...
 
TfcValue (const label i)
 Return forward circular value (ie, next value in the list) More...
 
const TrcValue (const label i) const
 Return reverse circular value (ie, previous value in the list) More...
 
TrcValue (const label i)
 Return reverse circular value (ie, previous value in the list) More...
 
const Tcdata () const noexcept
 Return pointer to the underlying array serving as data storage. More...
 
Tdata () noexcept
 Return pointer to the underlying array serving as data storage. More...
 
const char * cdata_bytes () const noexcept
 Return pointer to the underlying array serving as data storage,. More...
 
char * data_bytes () noexcept
 Return pointer to the underlying array serving as data storage,. More...
 
Tfirst ()
 Return the first element of the list. More...
 
const Tfirst () const
 Return first element of the list. More...
 
Tlast ()
 Return the last element of the list. More...
 
const Tlast () const
 Return the last element of the list. More...
 
std::streamsize size_bytes () const noexcept
 Number of contiguous bytes for the List data. More...
 
std::streamsize byteSize () const
 
void checkStart (const label start) const
 Check start is within valid range [0,size) More...
 
void checkSize (const label size) const
 Check size is within valid range [0,size]. More...
 
void checkRange (const label start, const label len) const
 Check that start and length define a valid range. More...
 
void checkIndex (const label i) const
 Check index is within valid range [0,size) More...
 
bool uniform () const
 True if all entries have identical values, and list is non-empty. More...
 
label find (const T &val, label pos=0) const
 Find index of the first occurrence of the value. More...
 
label rfind (const T &val, label pos=-1) const
 Find index of the last occurrence of the value. More...
 
bool found (const T &val, label pos=0) const
 True if the value if found in the list. More...
 
void moveFirst (const label i)
 Move element to the first position. More...
 
void moveLast (const label i)
 Move element to the last position. More...
 
void swapFirst (const label i)
 Swap element with the first element. Fatal on an empty list. More...
 
void swapLast (const label i)
 Swap element with the last element. Fatal on an empty list. More...
 
void shallowCopy (const UList< T > &list)
 Copy the pointer and size held by the given UList. More...
 
void deepCopy (const UList< T > &list)
 Copy elements of the given UList. Sizes must match! More...
 
template<class Addr >
void deepCopy (const IndirectListBase< T, Addr > &list)
 Copy elements of the given indirect list. Sizes must match! More...
 
SubList< Tslice (const label pos, label len=-1)
 Return SubList slice (non-const access) - no range checking. More...
 
const SubList< Tslice (const label pos, label len=-1) const
 Return SubList slice (const access) - no range checking. More...
 
SubList< Tslice (const labelRange &range)
 Return SubList slice (non-const access) - with range checking. More...
 
const SubList< Tslice (const labelRange &range) const
 Return SubList slice (const access) - with range checking. More...
 
Toperator[] (const label i)
 Return element of UList. More...
 
const Toperator[] (const label i) const
 Return element of constant UList. More...
 
 operator const Foam::List< T > & () const
 Allow cast to a const List<T>&. More...
 
void operator= (const T &val)
 Assignment of all entries to the given value. More...
 
void operator= (const Foam::zero)
 Assignment of all entries to zero. More...
 
iterator begin () noexcept
 Return an iterator to begin traversing the UList. More...
 
iterator end () noexcept
 Return an iterator to end traversing the UList. More...
 
const_iterator cbegin () const noexcept
 Return const_iterator to begin traversing the constant UList. More...
 
const_iterator cend () const noexcept
 Return const_iterator to end traversing the constant UList. More...
 
const_iterator begin () const noexcept
 Return const_iterator to begin traversing the constant UList. More...
 
const_iterator end () const noexcept
 Return const_iterator to end traversing the constant UList. More...
 
reverse_iterator rbegin ()
 Return reverse_iterator to begin reverse traversing the UList. More...
 
reverse_iterator rend ()
 Return reverse_iterator to end reverse traversing the UList. More...
 
const_reverse_iterator crbegin () const
 Return const_reverse_iterator to begin reverse traversing the UList. More...
 
const_reverse_iterator crend () const
 Return const_reverse_iterator to end reverse traversing the UList. More...
 
const_reverse_iterator rbegin () const
 Return const_reverse_iterator to begin reverse traversing the UList. More...
 
const_reverse_iterator rend () const
 Return const_reverse_iterator to end reverse traversing the UList. More...
 
label size () const noexcept
 The number of elements in the UList. More...
 
bool empty () const noexcept
 True if the UList is empty (ie, size() is zero) More...
 
void swap (UList< T > &list)
 Swap content with another UList of the same type in constant time. More...
 
bool operator== (const UList< T > &a) const
 Equality operation on ULists of the same type. More...
 
bool operator!= (const UList< T > &a) const
 The opposite of the equality operation. Takes linear time. More...
 
bool operator< (const UList< T > &list) const
 Compare two ULists lexicographically. Takes linear time. More...
 
bool operator> (const UList< T > &a) const
 Compare two ULists lexicographically. Takes linear time. More...
 
bool operator<= (const UList< T > &a) const
 Return true if !(a > b). Takes linear time. More...
 
bool operator>= (const UList< T > &a) const
 Return true if !(a < b). Takes linear time. More...
 
IstreamreadList (Istream &is)
 Read List contents from Istream. More...
 
void writeEntry (const word &keyword, Ostream &os) const
 Write the List as a dictionary entry with keyword. More...
 
OstreamwriteList (Ostream &os, const label shortLen=0) const
 Write List, with line-breaks in ASCII when length exceeds shortLen. More...
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type test (const label i) const
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type get (const label i) const
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type unset (const label i)
 
IstreamreadList (Istream &is)
 
OstreamwriteList (Ostream &os, const label) const
 
const booloperator[] (const label i) const
 
Foam::UPstream::commsStructoperator[] (const label procID)
 
const Foam::UPstream::commsStructoperator[] (const label procID) const
 
UPstream::commsStructoperator[] (const label procID)
 
const UPstream::commsStructoperator[] (const label procID) const
 
OstreamwriteList (Ostream &os, const label) const
 
IstreamreadList (Istream &is)
 

Additional Inherited Members

- Public Types inherited from List< T * >
typedef SubList< T * > subList
 Declare type of subList. More...
 
- Public Types inherited from UList< T >
typedef T value_type
 The value type the list contains. More...
 
typedef Tpointer
 The pointer type for non-const access to value_type items. More...
 
typedef const Tconst_pointer
 The pointer type for const access to value_type items. More...
 
typedef Treference
 The type used for storing into value_type objects. More...
 
typedef const Tconst_reference
 The type used for reading from constant value_type objects. More...
 
typedef Titerator
 Random access iterator for traversing a UList. More...
 
typedef const Tconst_iterator
 Random access iterator for traversing a UList. More...
 
typedef label size_type
 The type to represent the size of a UList. More...
 
typedef label difference_type
 The difference between iterator objects. More...
 
typedef std::reverse_iterator< iteratorreverse_iterator
 Reverse iterator (non-const access) More...
 
typedef std::reverse_iterator< const_iteratorconst_reverse_iterator
 Reverse iterator (const access) More...
 
- Static Public Member Functions inherited from List< T * >
static const List< T * > & null ()
 Return a null List. More...
 
- Static Public Member Functions inherited from UList< T >
static const UList< T > & null ()
 Return a UList reference to a nullObject. More...
 
static constexpr label max_size () noexcept
 The size of the largest possible UList. More...
 
- Protected Member Functions inherited from UList< T >
void setAddressableSize (const label n) noexcept
 Set addressed size to be inconsistent with allocated storage. More...
 
void size (const label n)
 Older name for setAddressableSize. More...
 
void writeEntry (Ostream &os) const
 Write the UList with its compound type. More...
 
labelRange validateRange (const labelRange &requestedRange) const
 
UList< T > & operator= (const UList< T > &)=delete
 No copy assignment (default: shallow copy) More...
 
void writeEntry (Ostream &os) const
 
void writeEntry (Ostream &os) const
 

Detailed Description

template<class T>
class Foam::Detail::PtrListDetail< T >

A rudimentary list of pointers used for PtrList, UPtrList, etc. This class is considered implementation detail and should not normally be used other than by OpenFOAM container classes.

It stores a list of pointers, but makes leaves memory management to the caller or sub-class. The free() method can be used explicitly as required.

Source files

Definition at line 61 of file PtrListDetail.H.

Constructor & Destructor Documentation

◆ PtrListDetail() [1/6]

constexpr PtrListDetail
inlineconstexprnoexcept

Default construct.

Definition at line 31 of file PtrListDetailI.H.

◆ PtrListDetail() [2/6]

PtrListDetail ( const label  len)
inlineexplicit

Construct with specified size, each element initialized to nullptr.

Definition at line 38 of file PtrListDetailI.H.

◆ PtrListDetail() [3/6]

PtrListDetail ( const UList< T * > &  list)
inlineexplicit

Copy a list of pointers.

The caller is responsible for memory management.

Definition at line 45 of file PtrListDetailI.H.

◆ PtrListDetail() [4/6]

PtrListDetail ( const PtrListDetail< T > &  list)
inline

Copy construct (shallow copies addresses)

Definition at line 55 of file PtrListDetailI.H.

◆ PtrListDetail() [5/6]

PtrListDetail ( PtrListDetail< T > &&  list)
inline

Move construct.

Definition at line 65 of file PtrListDetailI.H.

◆ PtrListDetail() [6/6]

PtrListDetail ( PtrListDetail< T > &  list,
bool  reuse 
)
inline

Copy or move (reuse) construct as specified.

Definition at line 75 of file PtrListDetailI.H.

Member Function Documentation

◆ count()

Foam::label count

Return the count of non-nullptr entries.

Definition at line 34 of file PtrListDetail.C.

References T.

◆ findNull()

Foam::label findNull

Locate the first null entry, -1 if there are none (or empty list)

Definition at line 51 of file PtrListDetail.C.

References T.

◆ checkNonNull()

void checkNonNull
inline

FatalError if any null exists in the list.

Definition at line 113 of file PtrListDetailI.H.

Referenced by UPtrList< T >::reorder(), and UPtrList< T >::sortOrder().

Here is the caller graph for this function:

◆ setNull()

void setNull

Assign all pointers to nullptr, without deleting.

Definition at line 73 of file PtrListDetail.C.

References UList< T >::size().

Here is the call graph for this function:

◆ free()

void free

Delete the allocated entries, but retain the list size.

Definition at line 86 of file PtrListDetail.C.

References UList< T >::size().

Here is the call graph for this function:

◆ clone() [1/2]

PtrListDetail< T > clone ( Args &&...  args) const

Make a copy by cloning each of the list pointers.

Referenced by PtrListDetail< T >::clone().

Here is the caller graph for this function:

◆ resize()

void resize ( const label  newLen)
inline

Reset size of list.

New entries are initialized to nullptr.

Definition at line 98 of file PtrListDetailI.H.

◆ setAddressableSize()

void setAddressableSize ( const label  n)
inlinenoexcept

Set addressed size to be inconsistent with allocated storage.

Use with care

Definition at line 88 of file PtrListDetailI.H.

References n, and UList< T >::setAddressableSize().

Here is the call graph for this function:

◆ write()

Foam::Ostream & write ( Ostream os,
const bool  trimNull = false 
) const

Write output, optionally silently trimming nullptrs.

Definition at line 35 of file PtrListDetailIO.C.

References Foam::abort(), Foam::decrIndent(), Foam::FatalError, FatalErrorInFunction, FUNCTION_NAME, Foam::incrIndent(), Foam::indent(), Foam::nl, os(), and T.

Here is the call graph for this function:

◆ operator=() [1/2]

void operator= ( const PtrListDetail< T > &  list)
inline

Copy assignment (shallow copies addresses)

Definition at line 129 of file PtrListDetailI.H.

References List< T >::operator=().

Here is the call graph for this function:

◆ operator=() [2/2]

void operator= ( PtrListDetail< T > &&  list)
inline

Move assignment.

Definition at line 139 of file PtrListDetailI.H.

References kinematicSingleLayer::transfer().

Here is the call graph for this function:

◆ setSize() [1/3]

void setSize ( const  label)
delete

◆ setSize() [2/3]

void setSize ( const  label,
const T  
)
delete

◆ setSize() [3/3]

void setSize ( const  label,
const T  
)
delete

◆ resize_nocopy()

void resize_nocopy ( const  label)
delete

◆ clone() [2/2]

Foam::Detail::PtrListDetail< T > clone ( Args &&...  args) const

Definition at line 108 of file PtrListDetail.C.

References args, PtrListDetail< T >::clone(), UList< T >::size(), and T.

Here is the call graph for this function:

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