#include <coherence/util/ConverterCollections.hpp>
Inherits WrapperCollections::AbstractWrapperCollection.
Inherited by MapValuesCollection.
Public Types | |||||||
typedef spec::Handle | Handle | ||||||
ConverterCollection Handle definition. | |||||||
typedef spec::View | View | ||||||
ConverterCollection View definition. | |||||||
typedef spec::Holder | Holder | ||||||
ConverterCollection Holder definition. | |||||||
Public Member Functions | |||||||
virtual bool | contains (Object::View v) const | ||||||
Determine if this collection contains the specified element.
| |||||||
virtual Iterator::Handle | iterator () const | ||||||
Return an Iterator over this collection.
| |||||||
virtual Muterator::Handle | iterator () | ||||||
Return an Iterator over this collection.
| |||||||
virtual ObjectArray::Handle | toArray (ObjectArray::Handle hao=NULL) const | ||||||
Return the contents of this collection as an ObjectArray. If the collection fits in the specified array, it is returned, otherwise, a new array is allocated that is the size of this collection. If this collection fits in the array with additional room then the element in the array immediately following the end of the collection is set to NULL. This can be useful in determining the length of this collection if the caller knows that the collection does not contain any NULL elements.
| |||||||
virtual bool | add (Object::Holder oh) | ||||||
Add the given element to this collection.
| |||||||
virtual bool | remove (Object::View v) | ||||||
Remove the supplied element from this collection.
| |||||||
virtual bool | containsAll (Collection::View vc) const | ||||||
Determine if this collection contains all elements from the supplied collection.
| |||||||
virtual bool | addAll (Collection::View vc) | ||||||
Add all elements from the supplied collection to this collection.
| |||||||
virtual bool | removeAll (Collection::View vc) | ||||||
Remove all instances of the elements in the supplied collection from this collection. Upon completion, contains() on this collection will return false for all elements in the supplied collection.
| |||||||
virtual bool | retainAll (Collection::View vc) | ||||||
Remove all elements from this collection that are not present in the supplied collection.
| |||||||
virtual bool | equals (Object::View that) const | ||||||
virtual size32_t | hashCode () const | ||||||
Return a hash code value for the Object. This method is supported for the benefit of hash-based containers.
The general contract of
The default implementation is identity based.
| |||||||
virtual TypedHandle < const String > | toString () const | ||||||
Output a human-readable description of this Object to the given stream. Note that when overriding this method the return type must be TypedHandle<const String> rather then String::View. These two types are assignment compatible but not equivalent and declaring the override with String::View will not be a compatible override. coherence::lang::operator<<(std::ostream, Object::View) is defined and will call into the toString method, to output Objects. If a managed String object is desired, the COH_TO_STRING macro can be used to build up a String from streamable contents and is generally how toString() will be implemented.
Object::View vKey = ... Object::View vValue = ... std::cout << vKey << " = " << vValue << std::endl; String::View vs = COH_TO_STRING(vKey << " = " << vValue); The COH_TO_STRING macro is also the most common way to implement the toString method. For example:
virtual TypedHandle<const String> Person::toString() const { return COH_TO_STRING("Name: " << f_sName << " SSN: " << f_nSSN); }
| |||||||
Protected Member Functions | |||||||
ConverterCollection (Collection::Handle hcollDelegate, Converter::View vConvUp, Converter::View vConvDown) | |||||||
Create a WrapperCollections::AbstractWrapperCollection which delegates to the specified Collection. | |||||||
ConverterCollection (Collection::View vcollDelegate, Converter::View vConvUp, Converter::View vConvDown) | |||||||
Create a WrapperCollections::AbstractWrapperCollection which delegates to the specified Collection. | |||||||
ConverterCollection (const ConverterCollection &that) | |||||||
Copy constructor. | |||||||
Protected Attributes | |||||||
FinalView< Converter > | f_vConvUp | ||||||
The Converter from the underlying container. | |||||||
FinalView< Converter > | f_vConvDown | ||||||
The Converter to the underlying container. |
ConverterCollection | ( | Collection::Handle | hcollDelegate, | |
Converter::View | vConvUp, | |||
Converter::View | vConvDown | |||
) | [protected] |
Create a WrapperCollections::AbstractWrapperCollection which delegates to the specified Collection.
hcollDelegate | the specified collection | |
vConvUp | the converter from the underlying Collection | |
vConvDown | the converter to the underlying Collection |
ConverterCollection | ( | Collection::View | vcollDelegate, | |
Converter::View | vConvUp, | |||
Converter::View | vConvDown | |||
) | [protected] |
Create a WrapperCollections::AbstractWrapperCollection which delegates to the specified Collection.
vcollDelegate | the specified collection | |
vConvUp | the converter from the underlying Collection | |
vConvDown | the converter to the underlying Collection |