RWTPtrVector(3C++)

Name
     RWTPtrVector<T> - Rogue Wave library class

Synopsis
              #include <rw/tpvector.h>



              RWTPtrVector<T> vec;




Descripton
     Class RWTPtrVector<T> is a simple parameterized vector of pointers to
     objects of type T.  It is most useful when you know precisely how many
     pointers must be held in the collection.  If the intention is to "insert"
     an unknown number of objects into a collection, then class
     RWTPtrOrderedVector<T> may be a better choice.  The class T can be of any
     type.

Persistence
     Isomorphic

Example
              #include <rw/tpvector.h>
          #include <rw/rwdate.h>
          #include <rw/rstream.h>
          main()  {
            RWTPtrVector<RWDate> week(7);
            RWDate begin;   // Today's date
            for (int i=0; i<7; i++)
              week[i] = new RWDate(begin++);
            for (i=0; i<7; i++)
            {
              cout << *week[i] << endl;
              delete week[i];
            }
            return 0;
          }


     Program output:

              March 16, 1996
          March 17, 1996
          March 18, 1996
          March 19, 1996
          March 20, 1996
          March 21, 1996
          March 22, 1996

Public Constructors
              RWTPtrVector<T>();


     Constructs an empty vector of length zero.

              RWTPtrVector<T>(size_t n);


     Constructs a vector of length n.  The initial values of the elements are
     undefined.  Hence, they can (and probably will) be garbage.

              RWTPtrVector<T>(size_t n, T* ival);


     Constructs a vector of length n, with each element pointing to the item
     *ival.

              RWTPtrVector<T>(const RWTPtrVector& v);


     Constructs self as a shallow copy of v.  After construction, pointers
     held by the two vectors point to the same items.

Public operators
              RWTPtrVector<T>&
          operator=(const RWTPtrVector<T>& v);


     Sets self to a shallow copy of v.  Afterwards, the two vectors will have
     the same length and pointersheld by the two vectors will point to the
     same items.

              RWTPtrVector<T>&
          operator=(T* p);


     Sets all elements in self to point to the item *p.

              T*&
          operator()(size_t i);
          T*
          operator()(size_t i) const;


     Returns the ith value in the vector.  The first variant can be used as an
     l-value, the second cannot.  The index i must be between zero and the
     length of the vector, less one.  No bounds checking is performed.

              T*&
          operator[](size_t i);
          T*
          operator[](size_t i) const;


     Returns the ith value in the vector.  The first variant can be used as an
     lvalue, the second cannot.  The index i must be between zero and the
     length of the vector, less one; or an exception of type TOOL_INDEX will
     be thrown.

Public Member Functions
              T* const *
          data() const;


     Returns a pointer to the raw data of the vector.  Should be used with
     care.

              size_t
          length() const;


     Returns the length of the vector.

              void
          reshape(size_t N);


     Changes the length of the vector to N.  If this results in the vector
     being lengthened, then the initial value of the additional elements is
     undefined.

              void
          resize(size_t N);


     Changes the length of the vector to N.  If this results in the vector
     being lengthened, then the initial value of the additional elements is
     set to nil.