Function CFSetCreateMutableCopy

Source
pub unsafe extern "C-unwind" fn CFSetCreateMutableCopy(
    allocator: Option<&CFAllocator>,
    capacity: CFIndex,
    the_set: Option<&CFSet>,
) -> Option<CFRetained<CFMutableSet>>
Available on crate features CFBase and CFSet only.
Expand description

Creates a new immutable set with the values from the given set.

Parameter allocator: The CFAllocator which should be used to allocate memory for the set and its storage for values. This parameter may be NULL in which case the current default CFAllocator is used. If this reference is not a valid CFAllocator, the behavior is undefined.

Parameter capacity: A hint about the number of values that will be held by the CFSet. Pass 0 for no hint. The implementation may ignore this hint, or may use it to optimize various operations. A set’s actual capacity is only limited by address space and available memory constraints). This parameter must be greater than or equal to the count of the set which is to be copied, or the behavior is undefined. If this parameter is negative, the behavior is undefined.

Parameter theSet: The set which is to be copied. The values from the set are copied as pointers into the new set (that is, the values themselves are copied, not that which the values point to, if anything). However, the values are also retained by the new set. The count of the new set will be the same as the copied set. The new set uses the same callbacks as the set to be copied. If this parameter is not a valid CFSet, the behavior is undefined.

Returns: A reference to the new mutable CFSet.