The class NCollection_Array1 represents unidimensional arrays of fixed size known at run time. The range of the index is user defined. An array1 can be constructed with a "C array". This functionality is useful to call methods expecting an Array1. It allows to carry the bounds inside the arrays. More...

#include <NCollection_Array1.hxx>

Inheritance diagram for NCollection_Array1< TheItemType >:

[legend]

Public Types
typedef NCollection_Allocator< TheItemType >	allocator_type
	Memory allocation.

using	value_type = TheItemType

using	size_type = size_t

using	difference_type = size_t

using	pointer = TheItemType *

using	const_pointer = const TheItemType *

using	reference = TheItemType &

using	const_reference = const TheItemType &

using	iterator = NCollection_IndexedIterator< std::random_access_iterator_tag, NCollection_Array1, value_type, false >

using	const_iterator = NCollection_IndexedIterator< std::random_access_iterator_tag, NCollection_Array1, value_type, true >

using	Iterator = NCollection_Iterator< NCollection_Array1< TheItemType > >

Public Member Functions
const_iterator	begin () const

iterator	begin ()

const_iterator	cbegin () const

iterator	end ()

const_iterator	end () const

const_iterator	cend () const

	NCollection_Array1 ()

	NCollection_Array1 (const Standard_Integer theLower, const Standard_Integer theUpper)

	NCollection_Array1 (const allocator_type &theAlloc, const Standard_Integer theLower, const Standard_Integer theUpper)

	NCollection_Array1 (const_reference theBegin, const Standard_Integer theLower, const Standard_Integer theUpper, const bool theUseBuffer=true)

	NCollection_Array1 (const NCollection_Array1 &theOther)
	Copy constructor.

	NCollection_Array1 (NCollection_Array1 &&theOther) noexcept
	Move constructor.

virtual	~NCollection_Array1 ()

void	Init (const_reference theValue)
	Initialise the items with theValue.

Standard_Integer	Size () const
	Size query.

Standard_Integer	Length () const
	Length query (the same)

Standard_Boolean	IsEmpty () const
	Return TRUE if array has zero length.

Standard_Integer	Lower () const
	Lower bound.

Standard_Integer	Upper () const
	Upper bound.

NCollection_Array1 &	Assign (const NCollection_Array1 &theOther)
	Copies data of theOther array to this. This array should be pre-allocated and have the same length as theOther; otherwise exception Standard_DimensionMismatch is thrown.

NCollection_Array1 &	Move (NCollection_Array1 &&theOther) noexcept
	Move assignment. This array will borrow all the data from theOther. The moved object will keep pointer to the memory buffer and range, but it will not free the buffer on destruction.

NCollection_Array1 &	Move (NCollection_Array1 &theOther)

NCollection_Array1 &	operator= (const NCollection_Array1 &theOther)
	Assignment operator;.

NCollection_Array1 &	operator= (NCollection_Array1 &&theOther) noexcept
	Move assignment operator;.

const_reference	First () const

reference	ChangeFirst ()

const_reference	Last () const

reference	ChangeLast ()

const_reference	Value (const Standard_Integer theIndex) const
	Constant value access.

const_reference	operator() (const Standard_Integer theIndex) const
	operator() - alias to Value

const_reference	operator[] (const Standard_Integer theIndex) const
	operator[] - alias to Value

reference	ChangeValue (const Standard_Integer theIndex)
	Variable value access.

reference	operator() (const Standard_Integer theIndex)
	operator() - alias to ChangeValue

reference	operator[] (const Standard_Integer theIndex)
	operator[] - alias to ChangeValue

void	SetValue (const Standard_Integer theIndex, const value_type &theItem)
	Set value.

void	SetValue (const Standard_Integer theIndex, value_type &&theItem)
	Set value.

void	UpdateLowerBound (const Standard_Integer theLower)
	Changes the lowest bound. Do not move data.

void	UpdateUpperBound (const Standard_Integer theUpper)
	Changes the upper bound. Do not move data.

void	Resize (const Standard_Integer theLower, const Standard_Integer theUpper, const Standard_Boolean theToCopyData)
	Resizes the array to specified bounds. No re-allocation will be done if length of array does not change, but existing values will not be discarded if theToCopyData set to FALSE.

bool	IsDeletable () const

Data Fields
friend	iterator

friend	const_iterator

Protected Member Functions
const_reference	at (const size_t theIndex) const

reference	at (const size_t theIndex)

template<typename U = TheItemType>
std::enable_if< std::is_arithmetic< U >::value, void >::type	construct ()

template<typename U = TheItemType>
std::enable_if<!std::is_arithmetic< U >::value, void >::type	construct ()

template<typename U = TheItemType>
std::enable_if< std::is_arithmetic< U >::value, void >::type	construct (const size_t, const size_t)

template<typename U = TheItemType>
std::enable_if<!std::is_arithmetic< U >::value, void >::type	construct (const size_t theFrom, const size_t theTo)

template<typename U = TheItemType>
std::enable_if< std::is_arithmetic< U >::value, void >::type	destroy ()

template<typename U = TheItemType>
std::enable_if<!std::is_arithmetic< U >::value, void >::type	destroy ()

template<typename U = TheItemType>
std::enable_if< std::is_arithmetic< U >::value, void >::type	destroy (pointer, const size_t, const size_t)

template<typename U = TheItemType>
std::enable_if<!std::is_arithmetic< U >::value, void >::type	destroy (pointer theWhat, const size_t theFrom, const size_t theTo)

void	copyConstruct (const pointer theFrom, const size_t theCount)

Protected Attributes
Standard_Integer	myLowerBound

size_t	mySize

pointer	myPointer = nullptr

bool	myIsOwner = false

allocator_type	myAllocator

Detailed Description

template<class TheItemType>
class NCollection_Array1< TheItemType >

The class NCollection_Array1 represents unidimensional arrays of fixed size known at run time. The range of the index is user defined. An array1 can be constructed with a "C array". This functionality is useful to call methods expecting an Array1. It allows to carry the bounds inside the arrays.

Examples:

Item tab[100]; //  an example with a C array
NCollection_Array1<Item> ttab (tab[0], 1, 100);
 
NCollection_Array1<Item> tttab (ttab(10), 10, 20); // a slice of ttab

If you want to reindex an array from 1 to Length do:

NCollection_Array1<Item> tab1 (tab (tab.Lower()), 1, tab.Length());

Warning: Programs client of such a class must be independent of the range of the first element. Then, a C++ for loop must be written like this

for (i = A.Lower(); i <= A.Upper(); i++)

theLower	new lower bound of array
theUpper	new upper bound of array
theToCopyData	flag to copy existing data into new array

Public Types

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ allocator_type

◆ const_iterator

◆ const_pointer

◆ const_reference

◆ difference_type

◆ iterator

◆ Iterator

◆ pointer

◆ reference

◆ size_type

◆ value_type

Constructor & Destructor Documentation

◆ NCollection_Array1() [1/6]

◆ NCollection_Array1() [2/6]

◆ NCollection_Array1() [3/6]

◆ NCollection_Array1() [4/6]

◆ NCollection_Array1() [5/6]

◆ NCollection_Array1() [6/6]

◆ ~NCollection_Array1()

Member Function Documentation

◆ Assign()

◆ at() [1/2]

◆ at() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ cbegin()

◆ cend()

◆ ChangeFirst()

◆ ChangeLast()

◆ ChangeValue()

◆ construct() [1/4]

◆ construct() [2/4]

◆ construct() [3/4]

◆ construct() [4/4]

◆ copyConstruct()

◆ destroy() [1/4]

◆ destroy() [2/4]

◆ destroy() [3/4]

◆ destroy() [4/4]

◆ end() [1/2]

◆ end() [2/2]

◆ First()

◆ Init()

◆ IsDeletable()

◆ IsEmpty()

◆ Last()

◆ Length()

◆ Lower()

◆ Move() [1/2]

◆ Move() [2/2]

◆ operator()() [1/2]

◆ operator()() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ Resize()

◆ SetValue() [1/2]

◆ SetValue() [2/2]

◆ Size()

◆ UpdateLowerBound()

◆ UpdateUpperBound()

◆ Upper()

◆ Value()

Field Documentation

◆ const_iterator

◆ iterator

◆ myAllocator

◆ myIsOwner

◆ myLowerBound

◆ myPointer

◆ mySize