PblSet* pblSetIntersection

( PblSet* setA,
  PblSet* setB )

Creates a new set containing the intersection of the elements of the two sets passed as parameters.

Documentation

Creates a new set containing the intersection of the elements of the two sets passed as parameters.

This function creates an empty clone of the smaller of the two parameter sets and then iterates the smaller of the two sets and adds all elements to the clone that are also contained in the larger set.

Parameters:

setA - The first set to intersect
setB - The second set to intersect

Returns:

PblSet * retPtr != NULL: A pointer to the new set.
PblSet * retPtr == NULL: An error, see pbl_errno:
PBL_ERROR_OUT_OF_MEMORY - Out of memory.
PBL_ERROR_PARAM_COLLECTION - A set cannot be iterated.
PBL_ERROR_CONCURRENT_MODIFICATION - A set was modified concurrently.

Alphabetic index