Function

CFBagReplaceValue

Replaces a value in a mutable bag.

Declaration

void CFBagReplaceValue(CFMutableBagRef theBag, const void *value);

Parameters

theBag

The bag from which value is to be replaced.

value

The value to be replaced in the collection. If this value does not already exist in the collection, the function does nothing. You may pass the value itself instead of a pointer if it is pointer-size or less. The equal callback provided when theBag was created is used to compare. If the equal callback was NULL, pointer equality (in C, ==) is used. If value, or any other value in theBag, is not understood by the equal callback, the behavior is undefined.

Discussion

Depending on the implementation of the equal callback specified when creating theBag, the object that is replaced by value may not have the same pointer equality.

See Also

Modifying a Mutable Bag

CFBagAddValue

Adds a value to a mutable bag.

CFBagRemoveAllValues

Removes all values from a mutable bag.

CFBagRemoveValue

Removes a value from a mutable bag.

CFBagSetValue

Sets a value in a mutable bag.