Function

dispatch_release

Decrements the reference count (the retain count) of a dispatch object.

Declaration

void dispatch_release(dispatch_object_t object);

Parameters

object

The object to release. This parameter cannot be NULL.

Discussion

A dispatch object is asynchronously deallocated once all references to it are released (the reference count becomes zero). When your application no longer needs a dispatch object that it has created, it should call this function to release its interest in the object and allow its memory to be deallocated when appropriate. Note that GCD does not guarantee that a given client has the last or only reference to a given object.

Your application does not need to retain or release the global (main and concurrent) dispatch queues; calling this function on global dispatch queues has no effect.

See Also

Managing Memory

dispatch_retain

Increments the reference count (the retain count) of a dispatch object.

dispatch_set_finalizer_f

Sets the finalizer function for a dispatch object.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software