An equality sequence is an ordered collection of elements. The elements are arranged so that each collection has a first and a last element, each element except the last has a next element, and each element but the first has a previous element. An equality sequence supports element equality, which gives you the ability, for example, to search for particular elements.
Use these members to construct and destruct objects of the class.
![]() |
public:
~IAEqualitySequence()
Removes all elements from the collection. Destructors are called for all elements contained in the collection and for elements that have been constructed in advance.
Side Effects
All cursors of the collection become undefined.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
IAEqualitySequence(INotifier&)
Use this constructor to create a collection with support for notification.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
protected:
IAEqualitySequence(IAEqualitySequence < Element > const&)
Constructs a collection.
The collection is unbounded and is initially empty.
Exception
IOutOfMemory
Note:
Windows | OS/2 | AIX |
Yes | Yes | Yes |
protected:
IAEqualitySequence()
This is the default constructor.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Use these members as comparison operators.
![]() |
public:
long compare( IAEqualitySequence < Element > const&, long ( * comparisonFunction ) ( Element const & , Element const & ) ) const
Compares the collection with the given collection.
Comparison yields
<0 if the collection is less than the given collection,
0 if the collection is equal to the given collection, and
>0 if the collection is greater than the given collection.
Comparison is defined by the first pair of
corresponding elements, in both collections, that are not equal.
If such a pair exists, the collection with the greater element
is the greater one.
Otherwise, the collection with more elements
is the greater one.
Return Value
Returns the result of the collection comparison.
Note:
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Use these members to execute miscellaneous tasks.
![]() |
public:
bool locateFirst(Element const&, ICursor&) const
Locates the first element in iteration order in the collection that is equal to the given element. Sets the cursor to the located element, or invalidates the cursor if no such element exists.
Precondition
The cursor must belong to the collection.
Return Value
Returns true if an element was found.
Exception
ICursorInvalidException
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
bool locateLast(Element const&, ICursor&) const
Locates the last element in iteration order in the collection that is equal to the given element. Sets the cursor to the located element, or invalidates the cursor if no such element exists.
Precondition
The cursor must belong to the collection.
Return Value
Returns true if an element was found.
Exception
ICursorInvalidException
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
bool locatePrevious(Element const&, ICursor&) const
Locates the previous element in iteration order that is equal to the given element, beginning at the element previous to the one specified by the given cursor and moving in reverse iteration order through the elements. Sets the cursor to the located element, or invalidates the cursor if no such element exists.
Preconditions
The cursor must belong to the collection and must point to an element of the collection.
Return Value
Returns true if an element was found.
Exceptions
ICursorInvalidException
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
bool operator !=( IAEqualitySequence < Element > const& ) const
Returns true if the cursor does not point to the same element (of the same collection) as the given cursor.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
bool operator ==( IAEqualitySequence < Element > const& ) const
Returns true if the cursor points to the same element (of the same collection) as the given cursor.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
virtual ~IACollection()
virtual bool add(Element const&)
virtual bool add(Element const&, ICursor&)
virtual void addAllFrom(IACollection < Element > const&)
void adoptStreamer(IACollectionStreamer*)
bool allElementsDo(IApplicator < Element >&)
bool allElementsDo( bool ( * applicatorFunction ) ( Element&, void * ) , void* additionalArgument = 0 )
bool allElementsDo( bool ( * applicatorFunction ) ( Element const&, void * ) , void* additionalArgument = 0 ) const
bool allElementsDo(IConstantApplicator < Element >&) const
Element const& any() const
Element const& anyElement() const
virtual void copy(IACollection < Element > const&)
INotifier& disableNotification()
Element const& elementAt(ICursor const&) const
Element& elementAt(ICursor const&)
INotifier& enableNotification(bool = true)
IACollection(INotifier&)
bool isBounded() const
bool isConsistent() const
bool isEmpty() const
bool isEnabledForNotification() const
bool isFull() const
INumber maxNumberOfElements() const
virtual ICursor* newCursor() const
ICursor* newMngCursor() const
INotifier const& notifier() const
INotifier& notifier()
INotifier& notifyObservers(INotificationEvent const&)
INumber numberOfElements() const
virtual void operator <<=(IDataStream&)
virtual void operator >>=(IDataStream&)
operator INotifier &() const
virtual INumber removeAll()
virtual INumber removeAll( bool ( * predicateFunction ) ( Element const&, void * ) , void* additionalArgument = 0 )
virtual void removeAt(ICursor&)
virtual void replaceAt(ICursor const&, Element const&)
bool setToFirst(ICursor&) const
bool setToNext(ICursor&) const
~IAEqualityCollection()
bool contains(Element const&) const
bool containsAllFrom(IACollection < Element > const&) const
IAEqualityCollection(INotifier&)
bool locate(Element const&, ICursor&) const
bool locateNext(Element const&, ICursor&) const
virtual bool locateOrAdd(Element const&, ICursor&)
virtual bool locateOrAdd(Element const&)
INumber numberOfOccurrences(Element const&) const
virtual bool remove(Element const&)
virtual INumber removeAllOccurrences(Element const&)
IACollection()
IACollection(IACollection < Element > const&)
static Implementation& ImplOf( IACollection < Element > const& )
IAEqualityCollection( IAEqualityCollection < Element > const& )
IAEqualityCollection()