Class Definition File | PfTypLs.idl |
Class C++ Binding | PfTypLs.xh |
Class Hierarchy |
SOMObject
ODObject
ODPlatformTypeList
|
Description | An object of the ODPlatformTypeList class is an ordered set of ODPlatformType elements. A platform type list is an ordered set of elements, each specifying a different value of some platform-specific type. Because these elements are of the ODPlatformType type, they can represent any platform-specific value used to identify data formats for data interchange. To create a platform type list, call the CreatePlatformTypeList method of the storage-system object. If the call to that method specifies an existing platform type list, the new platform type list is initialized to a copy of that list; otherwise, the new list is initialized to an empty list (a list with no elements). You can add elements one at a time to the end of the platform type list. OpenDoc ensures that each element of a platform type list is unique; if you attempt to add a value that is already in the list, the list remains unchanged. You can remove elements from the list, test whether the list contains a particular element, and get the number of elements in the list. If you need to perform an operation for each element of the list, you can create an object of the ODPlatformTypeListIterator class and use it to iterate through the list. |
Methods | The methods defined by the ODPlatformTypeList class include: |
Overridden Methods | There are no methods overridden by the ODPlatformTypeList class. |
This method adds an element to the end of this platform type list.
Signature
void AddLast (ODPlatformType type) |
Parameters
Returns
None.
Remarks
If this platform type list already contains the specified element, no action is taken; otherwise, the specified element is added to the end of the list.
Exception Handling
kODErrOutOfMemory | There is not enough memory to add the specified element to this platform type list. |
Related Methods
This method indicates whether this platform type list contains the specified element.
Signature
ODBoolean Contains (ODPlatformType type) |
Parameters
Returns
| kODTrue | This platform type list contains the specified element. |
| kODFalse | This platform type list does not contain the specified element. |
Related Methods
This method returns the number of elements in this platform type list.
Signature
ODULong Count () |
Parameters
None.
Returns
This method creates a platform type-list iterator for this platform type list.
Signature
ODPlatformTypeListIterator *CreatePlatformTypeListIterator () |
Parameters
None.
Returns
Remarks
You call this method if you need to apply an operation to each element of this platform type list.
While you are using the returned platform type-list iterator, you must not modify this platform type list; in particular, you must not add or remove elements, and you must not delete this platform type list.
You must delete the returned platform type-list iterator when it is no longer needed.
Exception Handling
kODErrOutOfMemory | There is not enough memory to create the iterator. |
This method removes the specified element from this platform type list.
Signature
void Remove (ODPlatformType type) |
Parameters
Returns
None.
Remarks
If this platform type list does not contain the specified element, no action is taken.
Related Methods