Rogue Wave banner
Previous fileTop of DocumentContentsIndex pageNext file
Essential Tools Module Reference Guide

RWTValDeque<T,A>

Module:  Essential Tools Module   Group:  STL-based Collection


Does not inherit

Local Index

Members

Non-Members

Synopsis

#include <rw/tvdeque.h> 
RWTValDeque<T,A> deq;

Description

This class maintains a collection of values implemented as a double-ended queue, or deque. Order is determined externally and elements are accessible by index. Use this class when insertions and deletions usually occur at either the beginning or the end of the collection.

Persistence

Isomorphic

Example

In this example, a double-ended queue of ints is exercised.

Program Input:

Program Output:

Related Classes

Classes RWTValSlist<T,A>, RWTValDlist<T,A>, RWTValSortedDlist<T>, and RWTValOrderedVector<T,A> also provide a Rogue Wave interface to C++-standard sequence collections. The list classes should be considered for frequent insertions (or removals) in the interior of the collection. The vector may be more efficient if most insertions and removals occur at the end of the collection.

Class deque<T,A<T*> > is the C++-standard collection that serves as the underlying implementation for this class.

Public Typedefs

typedef deque<T,A<T*> > container_type; 
typedef typename container_type::iterator iterator;
typedef typename container_type::const_iterator
  const_iterator;
typedef typename container_type::size_type size_type;
typedef T value_type; 
typedef T& reference; 
typedef const T& const_reference; 

Public Constructors

RWTValDeque<T,A>();
RWTValDeque<T,A>(const deque<T,A<T*> >& deq); 
RWTValDeque<T,A>(const RWTValDeque<T,A>& rwdeq);
RWTValDeque<T,A>(size_type n, const T& val = T());
RWTValDeque<T,A>(const T* first, const T* last);

Public Member Operators

RWTValDeque<T,A>&
operator=(const RWTValDeque<T,A>& deq); 
RWTValDeque<T,A>&
operator=(const deque<T,A<T*>>& deq);
bool
operator<(const RWTValDeque<T,A>& deq) const; 
bool
operator<(const deque<T,A<T*>>& deq) const;
bool
operator==(const RWTValDeque<T,A>& deq) const; 
bool
operator==(const deque<T,A>& deq) const;
reference
operator()(size_type i); 
const_reference
operator()(size_type i) const;
reference
operator[](size_type i); 
const_reference
operator[](size_type i) const;

Public Member Functions

void
append(const_reference a); 
void
apply(void (*fn)(reference,void*), void* d); 
void
apply(void (*fn)(const_reference,void*), void* d) const;
reference
at(size_type i); 
const_reference
at(size_type i) const;
iterator
begin();
const_iterator
begin() const;
void
clear();
bool
contains(const_reference a) const; 
bool
contains(bool (*fn)(const_reference,void*), void* d) const;
iterator
end();
const_iterator
end() const;
size_type
entries() const; 
bool
find(const_reference a,T& k) const; 
bool
find(bool (*fn)(const_reference,void*), void* d, 
     T& k) const; 
reference
first();
const_reference
first() const;
size_type
index(const_reference a) const; 
size_type
index(bool (*fn)(const_reference,void*), void* d) const;
bool
insert(const_reference a); 
void
insertAt(size_type i, const_reference a); 
bool
isEmpty() const; 
reference
last();
const_reference
last() const;
reference
maxElement();
const_reference
maxElement() const;
reference
minElement();
const_reference
minElement() const;
size_type 
occurrencesOf(const_reference a) const; 
size_type
occurrencesOf(bool (*fn)(const_reference,void*),void* d)
              const;
void
prepend(const_reference a); 
T
popBack();
T
popFront();
void
pushBack(const_reference a); 
void
pushFront(const_reference a); 
bool
remove(const_reference a); 
bool
remove(bool (*fn)(const_reference,void*), void* d);
size_type
removeAll(const_reference a); 
size_type
removeAll(bool (*fn)(const_reference,void*), void* d);
T
removeAt(size_type i); 
T
removeFirst();
T
removeLast();
size_type
replaceAll(const T& oldVal, const T& newVal); 
size_type
replaceAll(bool (*fn)(const T&,void*), void* d, 
       const T& newVal);
void
sort();
deque<T,A<T*> >&
std();
const deque<T,A<T*> >&
std() const;

Related Global Operators

RWvostream&
operator<<(RWvostream& strm, const RWTValDeque<T,A>& coll);
RWFile&
operator<<(RWFile& strm, const RWTValDeque<T,A>& coll);
RWvistream&
operator>>(RWvistream& strm, RWTValDeque<T,A>& coll); 
RWFile&
operator>>(RWFile& strm, RWTValDeque<T,A>& coll);
RWvistream&
operator>>(RWvistream& strm, RWTValDeque<T,A>*& p);
RWFile&
operator>>(RWFile& strm, RWTValDeque<T,A>*& p);


Previous fileTop of DocumentContentsIndex pageNext file

©2004 Copyright Quovadx, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.