A List obtained as a section of another List. More...

Inheritance diagram for SubList< T >:

Collaboration diagram for SubList< T >:

Public Member Functions
	SubList () noexcept=default
	Default construct, zero-sized and nullptr. More...

	SubList (const SubList< T > &) noexcept=default
	Copy construct, shallow copy. More...

	SubList (const UList< T > &list) noexcept
	Construct from UList, the entire size. More...

template<unsigned N>
	SubList (const FixedList< T, N > &list) noexcept
	Construct from FixedList, the entire size. More...

	SubList (const UList< T > &list, const label len)
	Construct from UList and sub-list size, start at 0. More...

	SubList (const UList< T > &list, const label len, const label start)
	Construct from UList, sub-list size and start index. More...

	SubList (const UList< T > &list, const labelRange &range)
	Construct from UList and a (start,size) range. More...

	SubList (const labelRange &range, const UList< T > &list)
	Construct from UList and a (start,size) range, but bypassing run-time range checking. More...

UList< T > &	reset (std::nullptr_t) noexcept
	Reset to zero-sized and nullptr. More...

UList< T > &	reset (const UList< T > &list) noexcept
	Reset to use entire UList. More...

UList< T > &	reset (const UList< T > &list, const label len)
	Reset to use UList with sub-list size, start at 0. More...

UList< T > &	reset (const UList< T > &list, const label len, const label start)
	Reset to use UList with sub-list size and start index. More...

UList< T > &	reset (const UList< T > &list, const labelRange &range)
	Reset to use UList with a (start,size) range. More...

UList< T > &	reset (const labelRange &range, const UList< T > &list)
	Reset to use UList with a (start,size) range, but bypassing run-time range checking. More...

	operator const Foam::List< T > & () const
	Allow cast to a const List<T>&. More...

void	operator= (const SubList< T > &list)
	Copy assign entries from given sub-list. Sizes must match! More...

void	operator= (const UList< T > &list)
	Copy assign entries from given list. Sizes must match! More...

template<class Addr >
void	operator= (const IndirectListBase< T, Addr > &list)
	Copy assign entries from given indirect list. Sizes must match! More...

void	operator= (const T &val)
	Assign all entries to the given value. More...

void	operator= (const Foam::zero)
	Assign all entries to zero. 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
	The forward circular index. The next index in the list which returns to the first at the end of the list. More...

label	rcIndex (const label i) const noexcept
	The reverse circular index. The previous index in the list which returns to the last at the beginning of the list. More...

const T &	fcValue (const label i) const
	Return forward circular value (ie, next value in the list) More...

T &	fcValue (const label i)
	Return forward circular value (ie, next value in the list) More...

const T &	rcValue (const label i) const
	Return reverse circular value (ie, previous value in the list) More...

T &	rcValue (const label i)
	Return reverse circular value (ie, previous value in the list) More...

const T *	cdata () const noexcept
	Return pointer to the underlying array serving as data storage. More...

T *	data () 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...

T &	front ()
	Access first element of the list, position [0]. More...

const T &	front () const
	Access first element of the list. More...

T &	back ()
	Access last element of the list, position [size()-1]. More...

const T &	back () const
	Access last element of the list, position [size()-1]. More...

std::streamsize	size_bytes () const noexcept
	Number of contiguous bytes for the List data. More...

std::streamsize	byteSize () const
	Number of contiguous bytes for the List data, runtime FatalError if type is not contiguous. More...

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...

bool	contains (const T &val) const
	True if the value is contained in the list. More...

bool	contains (const T &val, label pos, label len=-1) const
	Is the value contained in the list? More...

label	find (const T &val) const
	Find index of the first occurrence of the value. More...

label	find (const T &val, label pos, label len=-1) 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...

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 (T *__restrict__ ptr, const label len) noexcept
	Copy the pointer and size. More...

void	shallowCopy (const UList< T > &list) noexcept
	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< T >	slice (const label pos, label len=-1)
	Return SubList slice (non-const access) - no range checking. More...

const SubList< T >	slice (const label pos, label len=-1) const
	Return SubList slice (const access) - no range checking. More...

SubList< T >	slice (const labelRange &range)
	Return SubList slice (non-const access) - with range checking. More...

const SubList< T >	slice (const labelRange &range) const
	Return SubList slice (const access) - with range checking. More...

T &	operator[] (const label i)
	Return element of UList. More...

const T &	operator[] (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...

iterator	begin (const label i) noexcept
	Return iterator at offset i from begin, clamped to [0,size] range. 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...

const_iterator	cbegin (const label i) const noexcept
	Return const_iterator at offset i from begin, clamped to [0,size] range. More...

const_iterator	begin (const label i) const noexcept
	Return const_iterator at offset i from begin, clamped to [0,size] range. 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...

bool	empty () const noexcept
	True if List is empty (ie, size() is zero) More...

label	size () const noexcept
	The number of elements in the container. More...

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

void	swap (UList< T > &list) noexcept
	Swap content with another UList of the same type in constant time. More...

bool	operator== (const UList< T > &list) const
	Equality operation on ULists of the same type. More...

bool	operator!= (const UList< T > &list) 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 > &list) const
	Compare two ULists lexicographically. Takes linear time. More...

bool	operator<= (const UList< T > &list) const
	Return true if !(a > b). Takes linear time. More...

bool	operator>= (const UList< T > &list) const
	Return true if !(a < b). Takes linear time. More...

Istream &	readList (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...

Ostream &	writeList (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
	Test `bool` value at specified position, always false for out-of-range access. More...

template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type	get (const label i) const
	Return `bool` value at specified position, always false for out-of-range access. More...

template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type	unset (const label i)
	Unset the `bool` entry at specified position, always false for out-of-range access. More...

T &	first ()
	Access first element of the list, position [0]. More...

const T &	first () const
	Access first element of the list. More...

T &	last ()
	Access last element of the list, position [size()-1]. More...

const T &	last () const
	Access last element of the list, position [size()-1]. More...

bool	found (const T &val, label pos=0) const
	Same as contains() More...

template<>
const bool &	operator[] (const label i) const

template<>
UPstream::commsStruct &	operator[] (const label procID)

template<>
const UPstream::commsStruct &	operator[] (const label procID) const

template<>
Foam::UPstream::commsStruct &	operator[] (const label procID)

template<>
const Foam::UPstream::commsStruct &	operator[] (const label procID) const

Static Public Member Functions
static const SubList< T > &	null ()
	Return a null SubList. 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...

Additional Inherited Members
Public Types inherited from UList< T >
typedef T	value_type
	The value type the list contains. More...

typedef T *	pointer
	The pointer type for non-const access to value_type items. More...

typedef const T *	const_pointer
	The pointer type for const access to value_type items. More...

typedef T &	reference
	The type used for storing into value_type objects. More...

typedef const T &	const_reference
	The type used for reading from constant value_type objects. More...

typedef T *	iterator
	Random access iterator for traversing a UList. More...

typedef const T *	const_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< iterator >	reverse_iterator
	Reverse iterator (non-const access) More...

typedef std::reverse_iterator< const_iterator >	const_reverse_iterator
	Reverse iterator (const access) 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
	Return a validated (start,size) subset range, which means that it always addresses a valid section of the list. More...

void	fill_uniform (const T &val)
	Assign all entries to the given value. More...

void	fill_uniform (const Foam::zero)
	Assign all entries to zero. More...

UList< T > &	operator= (const UList< T > &)=delete
	No copy assignment (default: shallow copy) More...

template<>
void	writeEntry (Ostream &os) const
	Character list writeEntry. More...

template<>
void	operator= (const Foam::zero)
	Character list assign zero - avoids Foam::zero casting ambiguities. More...

template<>
void	writeEntry (Ostream &os) const

template<>
void	operator= (const Foam::zero)

Detailed Description

template<class T>
class Foam::SubList< T >

A List obtained as a section of another List.

Since the SubList is itself unallocated, no storage is allocated or de-allocated during its use. To achieve this behaviour, SubList is derived from UList rather than List.

Source files

Definition at line 50 of file SubList.H.

Constructor & Destructor Documentation

◆ SubList() [1/8]

SubList ( )

defaultnoexcept

Default construct, zero-sized and nullptr.

◆ SubList() [2/8]

SubList ( const SubList< T > & )

defaultnoexcept

Copy construct, shallow copy.

◆ SubList() [3/8]

SubList ( const UList< T > & list )

inlineexplicitnoexcept

Construct from UList, the entire size.

Definition at line 37 of file SubListI.H.

◆ SubList() [4/8]

SubList ( const FixedList< T, N > & list )

inlineexplicitnoexcept

Construct from FixedList, the entire size.

Definition at line 48 of file SubListI.H.

◆ SubList() [5/8]

SubList	(	const UList< T > &	list,
		const label	len
	)

inline

Construct from UList and sub-list size, start at 0.

Definition at line 58 of file SubListI.H.

◆ SubList() [6/8]

SubList	(	const UList< T > &	list,
		const label	len,
		const label	start
	)

inline

Construct from UList, sub-list size and start index.

Definition at line 73 of file SubListI.H.

◆ SubList() [7/8]

SubList	(	const UList< T > &	list,
		const labelRange &	range
	)

inline

Construct from UList and a (start,size) range.

The range is subsetted with the list size itself to ensure that the result always addresses a valid section of the list.

Definition at line 89 of file SubListI.H.

◆ SubList() [8/8]

SubList	(	const labelRange &	range,
		const UList< T > &	list
	)

inline

Construct from UList and a (start,size) range, but bypassing run-time range checking.

Definition at line 106 of file SubListI.H.

Member Function Documentation

◆ null()

const Foam::SubList< T > & null ( )

inlinestatic

Return a null SubList.

Definition at line 27 of file SubListI.H.

◆ reset() [1/6]

Foam::UList< T > & reset ( std::nullptr_t )

inlinenoexcept

Reset to zero-sized and nullptr.

Definition at line 118 of file SubListI.H.

◆ reset() [2/6]

Foam::UList< T > & reset ( const UList< T > & list )

inlinenoexcept

Reset to use entire UList.

Definition at line 127 of file SubListI.H.

◆ reset() [3/6]

Foam::UList< T > & reset	(	const UList< T > &	list,
		const label	len
	)

inline

Reset to use UList with sub-list size, start at 0.

Definition at line 138 of file SubListI.H.

◆ reset() [4/6]

Foam::UList< T > & reset	(	const UList< T > &	list,
		const label	len,
		const label	start
	)

inline

Reset to use UList with sub-list size and start index.

Definition at line 154 of file SubListI.H.

◆ reset() [5/6]

Foam::UList< T > & reset	(	const UList< T > &	list,
		const labelRange &	range
	)

inline

Reset to use UList with a (start,size) range.

The range is subsetted with the list size itself to ensure that the result always addresses a valid section of the list.

Definition at line 175 of file SubListI.H.

◆ reset() [6/6]

Foam::UList< T > & reset	(	const labelRange &	range,
		const UList< T > &	list
	)

inline

Reset to use UList with a (start,size) range, but bypassing run-time range checking.

Definition at line 199 of file SubListI.H.

◆ operator const Foam::List< T > &()

operator const Foam::List< T > & ( ) const

inline

Allow cast to a const List<T>&.

Definition at line 220 of file SubListI.H.

◆ operator=() [1/5]

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

inline

Copy assign entries from given sub-list. Sizes must match!

Definition at line 227 of file SubListI.H.

◆ operator=() [2/5]

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

inline

Copy assign entries from given list. Sizes must match!

Definition at line 234 of file SubListI.H.

◆ operator=() [3/5]

void operator= ( const IndirectListBase< T, Addr > & list )

inline

Copy assign entries from given indirect list. Sizes must match!

Definition at line 242 of file SubListI.H.

◆ operator=() [4/5]

void operator= ( const T & val )

inline

Assign all entries to the given value.

Definition at line 249 of file SubListI.H.

◆ operator=() [5/5]

void operator= ( const Foam::zero )

inline

Assign all entries to zero.

Definition at line 256 of file SubListI.H.

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

src/OpenFOAM/containers/Lists/List/SubList.H
src/OpenFOAM/containers/Lists/List/SubListI.H

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

template<class T> class Foam::SubList< T >

Constructor & Destructor Documentation

◆ SubList() [1/8]

◆ SubList() [2/8]

◆ SubList() [3/8]

◆ SubList() [4/8]

◆ SubList() [5/8]

◆ SubList() [6/8]

◆ SubList() [7/8]

◆ SubList() [8/8]

Member Function Documentation

◆ null()

◆ reset() [1/6]

◆ reset() [2/6]

◆ reset() [3/6]

◆ reset() [4/6]

◆ reset() [5/6]

◆ reset() [6/6]

◆ operator const Foam::List< T > &()

◆ operator=() [1/5]

◆ operator=() [2/5]

◆ operator=() [3/5]

◆ operator=() [4/5]

◆ operator=() [5/5]

template<class T>
class Foam::SubList< T >