int pblSetEquals

( PblSet* set, void* collection )

Compares the specified collection with this set for equality.

Documentation

Compares the specified collection with this set for equality.

Returns true if the specified collection is a collection, the two collections have the same size and every member of the specified collection is contained in this set.

In other words, two collections are defined to be equal as sets if they contain the same elements.

For hash sets this method has a time complexity of O(M) and for tree sets this method has a time complexity of O(M * Log N ), with N being the size of the set and M being the number of elements in the object compared.

Parameters:

set - The set to compare with.
collection - The collection to be compared for equality with this set.

Returns:

int rc > 0: The specified collection is equal to this set.
int rc == 0: The specified collection is not equal to this set.
int rc < 0: An error, see pbl_errno:
PBL_ERROR_PARAM_COLLECTION - The collection cannot be iterated.
PBL_ERROR_CONCURRENT_MODIFICATION - The collection was modified concurrently.

Alphabetic index