Template specialization for S=0 - indication no stack space at all should be made. More...

#include <farray.h>

Public Types
using	size_type = uint64
	Typedef to assist in STL compatibility.

using	iterator = T *
	Typedef to assist in STL compatibility.

using	const_iterator = const T *
	Typedef to assist in STL compatibility.

using	value_type = T

Public Member Functions
	FArray ()
	Default constructor - the array size is zero.

	FArray (size_type s, const T &t=T())

template<uint64 S2>
	FArray (const FArray< T, S2 > &f)
	Copy constructor, valid for FArrays of the same data type but different stack lengths.

	FArray (const FArray< T, 0 > &f)
	Specialized copy constructor, for the special case of when the stack lengths are the same.

	FArray (std::initializer_list< T > l)

	~FArray ()
	Destructor.

template<uint64 S2>
const FArray< T, 0 > &	operator= (const FArray< T, S2 > &f)
	Assignment operator, valid for FArrays of the same data type but different stack lengths.

const FArray< T, 0 > &	operator= (const FArray< T, 0 > &f)
	Specialized assignment operator, for the special case of when the stack lengths are the same.

const size_type &	size () const

const size_type &	allocated () const

bool	empty () const

T *	data ()

const T *	data () const

T &	front ()

const T &	front () const

T &	back ()

const T &	back () const

void	push_back (const T &t)
	Adds a new element to the end of the array, increasing the array size by one.

T *	emplace_back ()

T *	emplace_n_back (uint64 n)

void	pop_back ()
	Removes the last element in the array. The results are undefined if the array is of zero length.

void	resize (size_type i, const T &t=T())

iterator	insert (size_type i, const T &t)

iterator	insert (iterator it, const T &t)

void	put (size_type i, const T &t)
	Adds a value to the array, first making certain it is big enough to hold it.

template<class C >
void	append (const C &in)
	Appends the contents of one FArray onto another.

bool	remove (size_type i)

size_type	removeAll (const T &t)

void	clear ()

void	clear_no_destruct ()

void	reset ()

void	clip ()

iterator	begin ()

const_iterator	begin () const

const_iterator	constBegin () const

iterator	end ()

const_iterator	end () const

const_iterator	constEnd () const

T &	at (size_type i)

const T &	at (size_type i) const

T &	operator[] (size_type i)

const T &	operator[] (size_type i) const

T	value (int i, const T &t=T()) const

T	value (quint32 i, const T &t=T()) const

T	value (uint64 i, const T &t=T()) const

Detailed Description

template<class T>
class FArray< T, 0 >

Template specialization for S=0 - indication no stack space at all should be made.

Constructor & Destructor Documentation

◆ FArray()

template<class T >

FArray< T, 0 >::FArray	(	size_type	s,
		const T &	t = `T()`
	)

inline

Constructs the array with size s, and each entry in the array has initial value t.

Parameters

s	Initial size of the array.
t	The value each element is initialized with.

Member Function Documentation

◆ allocated()

template<class T >

const size_type& FArray< T, 0 >::allocated ( ) const

inline

Returns: the size allocated internally – this will be S (the stack length) unless the array has been made large enough to force heap access.

◆ at() [1/2]

template<class T >

T& FArray< T, 0 >::at ( size_type i )

inline

Returns: A reference to the element at the ith location in the array. Undefined if the array length is less than or equal to i. No bounds checking is performed, even in a debug compile.

◆ at() [2/2]

template<class T >

const T& FArray< T, 0 >::at ( size_type i ) const

inline

Returns: A const reference to the element at the ith location in the array. Undefined if the array length is less than or equal to i. No bounds checking is performed, even in a debug compile.

◆ back() [1/2]

template<class T >

T& FArray< T, 0 >::back ( )

inline

Returns: a reference to the last element in the array. This is undefined if the array is of zero length.

◆ back() [2/2]

template<class T >

const T& FArray< T, 0 >::back ( ) const

inline

Returns: a const reference to the last element in the array. This is undefined if the array is of zero length.

◆ begin() [1/2]

template<class T >

iterator FArray< T, 0 >::begin ( )

inline

Returns: An iterator representing the first element in the array.

Implemented as a pointer. STL compatible as a random-access iterator.

◆ begin() [2/2]

template<class T >

const_iterator FArray< T, 0 >::begin ( ) const

inline

Returns: An iterator representing the first element in the array.

Implemented as a pointer. STL compatible as a random-access iterator.

◆ clear()

template<class T >

void FArray< T, 0 >::clear ( )

inline

Resets the array size to zero, destroying all current elements. The allocated length is not changed.

◆ clear_no_destruct()

template<class T >

void FArray< T, 0 >::clear_no_destruct ( )

inline

Resets the array size to zero. No destructor is called for the array elements. The allocated length is not changed.

◆ clip()

template<class T >

void FArray< T, 0 >::clip ( )

inline

Reduces the allocated length to the actual length of the array, or the stack length, whichever is greater. This and reset() are the only means of reducing the allocated length of an existing FArray.

◆ constBegin()

template<class T >

const_iterator FArray< T, 0 >::constBegin ( ) const

inline

Returns: An iterator representing the first element in the array.

Implemented as a pointer. STL compatible as a random-access iterator.

◆ constEnd()

template<class T >

const_iterator FArray< T, 0 >::constEnd ( ) const

inline

Returns: An iterator representing one past the last element in the array.

Implemented as a pointer. STL compatible as a random-access iterator.

◆ data() [1/2]

template<class T >

T* FArray< T, 0 >::data ( )

inline

Returns: a pointer to the beginning of the array data. An FARRAY guarantees that it's internal data is contiguous.

◆ data() [2/2]

template<class T >

const T* FArray< T, 0 >::data ( ) const

inline

Returns: a const pointer to the beginning of the array data. An FARRAY guarantees that it's internal data is contiguous.

◆ emplace_back()

template<class T >

T* FArray< T, 0 >::emplace_back ( )

inline

To avoid creating a temporary object, can call this to get memory location of new lcoation at end of stack and then use it to do an in-place new. new(fa.emplace_back()) Fred(arg1,arg2);

◆ emplace_n_back()

template<class T >

T* FArray< T, 0 >::emplace_n_back ( uint64 n )

inline

emplace_n_back: make sure n new positions are allocated and return a pointer to the first of those positions; caller should create objects at those positions.

◆ empty()

template<class T >

bool FArray< T, 0 >::empty ( ) const

inline

Returns: true if the array is of zero length.

◆ end() [1/2]

template<class T >

iterator FArray< T, 0 >::end ( )

inline

Returns: An iterator representing one past the last element in the array.

Implemented as a pointer. STL compatible as a random-access iterator.

◆ end() [2/2]

template<class T >

const_iterator FArray< T, 0 >::end ( ) const

inline

Returns: An iterator representing one past the last element in the array.

Implemented as a pointer. STL compatible as a random-access iterator.

◆ front() [1/2]

template<class T >

T& FArray< T, 0 >::front ( )

inline

Returns: a reference to the first element in the array. This is undefined if the array is of zero length.

◆ front() [2/2]

template<class T >

const T& FArray< T, 0 >::front ( ) const

inline

Returns: a const reference to the first element in the array. This is undefined if the array is of zero length.

◆ insert() [1/2]

template<class T >

iterator FArray< T, 0 >::insert	(	size_type	i,
		const T &	t
	)

inline

Inserts a value intot he array at position i (the new position it will occupy). If I is past the end of the array, adds to end.

◆ insert() [2/2]

template<class T >

iterator FArray< T, 0 >::insert	(	iterator	it,
		const T &	t
	)

inline

Inserts a value intot he array at position i (the new position it will occupy). If I is past the end of the array, adds to end.

◆ operator[]() [1/2]

template<class T >

T& FArray< T, 0 >::operator[] ( size_type i )

inline

Returns: A reference to the element at the ith location in the array. Undefined if the array length is less than or equal to i. No bounds checking is performed, even in a debug compile.

◆ operator[]() [2/2]

template<class T >

const T& FArray< T, 0 >::operator[] ( size_type i ) const

inline

Returns: A const reference to the element at the ith location in the array. Undefined if the array length is less than or equal to i. No bounds checking is performed, even in a debug compile.

◆ remove()

template<class T >

bool FArray< T, 0 >::remove ( size_type i )

inline

Removes a value from the array at position i If i is past the end of the array, does nothing.

◆ removeAll()

template<class T >

size_type FArray< T, 0 >::removeAll ( const T & t )

inline

Removes all values from the array matching t (operator==). Returns the number of objects removed

◆ reset()

template<class T >

void FArray< T, 0 >::reset ( )

inline

Resets the array size to zero, destroying all current elements. The allocated length is reset back to the stack length, and any heap memory is returned.

◆ resize()

template<class T >

void FArray< T, 0 >::resize	(	size_type	i,
		const T &	t = `T()`
	)

inline

Parameters

i	The new array length.
t	The value assigned to new array elements (if any). Changes the actual length (not the allocated length) of the array to i. May increase the allocated length, but will not decrease it.

◆ size()

template<class T >

const size_type& FArray< T, 0 >::size ( ) const

inline

Returns: the current size of the array - NOT the stack length OR the size allocated internally.

◆ value() [1/3]

template<class T >

T FArray< T, 0 >::value	(	int	i,
		const T &	t = `T()`
	)		const

inline

Returns: A copy of the value a the ith location in the array, or t if i in an invalid index. This version uses a signed integer type (32 bit) as an index.

◆ value() [2/3]

template<class T >

T FArray< T, 0 >::value	(	quint32	i,
		const T &	t = `T()`
	)		const

inline

Returns: A copy of the value a the ith location in the array, or t if i in an invalid index. This version uses an unsigned 32 bit integer type as an index.

◆ value() [3/3]

template<class T >

T FArray< T, 0 >::value	(	uint64	i,
		const T &	t = `T()`
	)		const

inline

Returns: A copy of the value a the ith location in the array, or t if i in an invalid index. This version uses an unsigned 64 bit integer type as an index.

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

C:/Source/itasca-suite/common/base/src/farray.h

Public Types

Public Member Functions

Detailed Description

template<class T> class FArray< T, 0 >

Constructor & Destructor Documentation

◆ FArray()

Member Function Documentation

◆ allocated()

◆ at() [1/2]

◆ at() [2/2]

◆ back() [1/2]

◆ back() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ clear()

◆ clear_no_destruct()

◆ clip()

◆ constBegin()

◆ constEnd()

◆ data() [1/2]

◆ data() [2/2]

◆ emplace_back()

◆ emplace_n_back()

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ front() [1/2]

◆ front() [2/2]

◆ insert() [1/2]

◆ insert() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ remove()

◆ removeAll()

◆ reset()

◆ resize()

◆ size()

◆ value() [1/3]

◆ value() [2/3]

◆ value() [3/3]

template<class T>
class FArray< T, 0 >