CFBagAddValue |
||||
Header: | CFBag.h | Carbon status: | Supported | |
Adds a value to a mutable CFBag object
void CFBagAddValue ( CFMutableBagRef bag, const void *value );
Pass a reference to a mutable CFBag object. References to immutable CFBag objects will cause indeterminate behavior.
Pass a pointer to the value to add to the CFBag (or the value itself, it it fits into the size of a pointer).
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.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)