PblSet* pblSetUnion

( PblSet* setA,
  PblSet* setB )

Creates a new set containing the union of the elements of both sets passed as parameters.

Documentation

Creates a new set containing the union of the elements of both sets passed as parameters.

This functions clones the larger of the two parameter sets and then adds all elements from the smaller set to the clone.

Parameters:

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

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