---

ACE_Array Class Template Reference

A dynamic array class. More...

#include <Containers_T.h>

Inheritance diagram for ACE_Array:

[legend]Collaboration diagram for ACE_Array:

[legend]List of all members.

Public Types
typedef T	TYPE
typedef ACE_Array_Iterator< T >	ITERATOR
Public Methods
	ACE_Array (size_t size=0, ACE_Allocator *alloc=0)
	Dynamically create an uninitialized array. More...
	ACE_Array (size_t size, const T &default_value, ACE_Allocator *alloc=0)
	Dynamically initialize the entire array to the <default_value>. More...
	ACE_Array (const ACE_Array< T > &s)
	Copy constructor. More...
void	operator= (const ACE_Array< T > &s)
	Assignment operator. More...
int	operator== (const ACE_Array< T > &s) const
	Equality comparison operator. More...
int	operator!= (const ACE_Array< T > &s) const
	Inequality comparison operator. More...

---

Detailed Description

template<class T>
class ACE_Array< T >

A dynamic array class.

This class extends ACE_Array_Base, adding comparison operators.

Requirements and Performance Characteristics

• Internal Structure Dynamic array
• Duplicates allowed? Yes
• Random access allowed? Yes
• Search speed N/A
• Insert/replace speed O(1)
• Iterator still valid after change to container?
  • In general, yes.
  • If array size is changed during iteration, no.
• Frees memory for removed elements? No
• Items inserted by Value
• Requirements for contained type
  1. Default constructor
  2. Copy constructor
  3. operator=
  4. operator!=

See also:

ACE_Array_Base. This class inherits its operations and requirements.

Definition at line 1915 of file Containers_T.h.

---

Member Typedef Documentation

template<class T> typedef ACE_Array_Iterator<T> ACE_Array::ITERATOR

Reimplemented from ACE_Array_Base. Definition at line 1921 of file Containers_T.h.

template<class T> typedef T ACE_Array::TYPE

Reimplemented from ACE_Array_Base. Definition at line 1919 of file Containers_T.h.

---

Constructor & Destructor Documentation

template<class T> ACE_INLINE ACE_Array< T >::ACE_Array (  size_t    size = 0, ACE_Allocator *    alloc = 0 )

Dynamically create an uninitialized array. Initialize an empty array of the specified size using the provided allocation strategy. Definition at line 272 of file Containers_T.i. : ACE_Array_Base<T> (size, alloc) { }

template<class T> ACE_INLINE ACE_Array< T >::ACE_Array (  size_t    size, const T &    default_value, ACE_Allocator *    alloc = 0 )

Dynamically initialize the entire array to the <default_value>. Initialize an array the given size placing the default_value in each index. Definition at line 279 of file Containers_T.i. : ACE_Array_Base<T> (size, default_value, alloc) { }

template<class T> ACE_INLINE ACE_Array< T >::ACE_Array (  const ACE_Array< T > &    s )

Copy constructor. The copy constructor performs initialization by making an exact copy of the contents of parameter <s>, i.e., *this == s will return true. Definition at line 289 of file Containers_T.i. : ACE_Array_Base<T> (s) { }

---

Member Function Documentation

template<class T> ACE_INLINE int ACE_Array< T >::operator!= (  const ACE_Array< T > &    s )  const

Inequality comparison operator. Compare this array with <s> for inequality such that <*this> != <s> is always the complement of the boolean return value of <*this> == <s>. Definition at line 308 of file Containers_T.i. { return !(*this == s); }

template<class T> ACE_INLINE void ACE_Array< T >::operator= (  const ACE_Array< T > &    s )

Assignment operator. Assignment operator performs an assignment by making an exact copy of the contents of parameter <s>, i.e., *this == s will return true. Note that if the <max_size_> of <array_> is >= than <s.max_size_> we can copy it without reallocating. However, if <max_size_> is < <s.max_size_> we must delete the <array_>, reallocate a new <array_>, and then copy the contents of <s>. Definition at line 297 of file Containers_T.i. References ACE_Array_Base::operator=. { // Check for "self-assignment". if (this != &s) this->ACE_Array_Base<T>::operator= (s); }

template<class T> int ACE_Array< T >::operator== (  const ACE_Array< T > &    s )  const

Equality comparison operator. Compare this array with <s> for equality. Two arrays are equal if their <size>'s are equal and all the elements from 0 .. <size> are equal. Definition at line 1861 of file Containers_T.cpp. References ACE_Array_Base::size. { if (this == &s) return 1; else if (this->size () != s.size ()) return 0; for (size_t slot = 0; slot < s.size (); slot++) if ((*this)[slot] != s[slot]) return 0; return 1; }

---

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

• Containers_T.h
• Containers_T.cpp
• Containers_T.i

---