NCollection_Vector.hxx File Reference

#include <Standard_Macro.hxx>
#include <NCollection_DynamicArray.hxx>

Typedefs
template<class TheItemType >
using	NCollection_Vector
	Class NCollection_Vector (dynamic array of objects)

Functions
	Standard_HEADER_DEPRECATED ("NCollection_Vector.hxx is deprecated since OCCT 8.0.0. Use " "NCollection_DynamicArray.hxx directly.")

Typedef Documentation

NCollection_Vector

template<class TheItemType >

using NCollection_Vector

Initial value:

 NCollection_DynamicArray<TheItemType> 
  "NCollection_Vector is deprecated, use NCollection_DynamicArray directly")

Class NCollection_Vector (dynamic array of objects)

The Vector is always created with 0 length. It can be enlarged by two means:

1. Calling the method Append (val) - then "val" is added to the end of the vector (the vector length is incremented)
2. Calling the method SetValue (i, val) - if "i" is greater than or equal to the current length of the vector, the vector is enlarged to accomo- date this index

The methods Append and SetValue return a non-const reference to the copied object inside the vector. This reference is guaranteed to be valid until the vector is destroyed. It can be used to access the vector member directly or to pass its address to other data structures.

The vector iterator remembers the length of the vector at the moment of the creation or initialisation of the iterator. Therefore the iteration begins at index 0 and stops at the index equal to (remembered_length-1). It is OK to enlarge the vector during the iteration.

Function Documentation

Standard_HEADER_DEPRECATED()

Standard_HEADER_DEPRECATED

(

"NCollection_Vector.hxx is deprecated since OCCT 8.0.0. Use " "NCollection_DynamicArray.hxx directly."

)