CFBagAddValue

Header: CFBag.h Carbon status: Supported

Adds a value to a mutable CFBag object

void CFBagAddValue (
    CFMutableBagRef bag, 
    const void *value
);
Parameter descriptions
bag

Pass a reference to a mutable CFBag object. References to immutable CFBag objects will cause indeterminate behavior.

value

Pass a pointer to the value to add to the CFBag (or the value itself, it it fits into the size of a pointer).

DISCUSSION

The CFBagAddValue function adds a given value to a CFBag collection object. If the value already exists in the collection, the new value is allowed to coexist in the collection. In this case, no memory is allocated for the added value; an internal count is simply incremented. This behavior is unlike a set, which prevents the addition of a value identical to an already contained value.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)