Class

NotificationQueue

NSNotificationQueue objects (or simply notification queues) act as buffers for notification centers (instances of NSNotificationCenter). Whereas a notification center distributes notifications when posted, notifications placed into the queue can be delayed until the end of the current pass through the run loop or until the run loop is idle. Duplicate notifications can also be coalesced so that only one notification is sent although multiple notifications are posted. A notification queue maintains notifications (instances of NSNotification) generally in a first in first out (FIFO) order. When a notification rises to the front of the queue, the queue posts it to the notification center, which in turn dispatches the notification to all objects registered as observers.

Overview

Every thread has a default notification queue, which is associated with the default notification center for the task. You can create your own notification queues and have multiple queues per center and thread.

Nested Types

NotificationQueue.PostingStyle

These constants specify when notifications are posted.

NotificationQueue.NotificationCoalescing

These constants specify how notifications are coalesced.

Symbols

Creating Notification Queues

init(notificationCenter: NotificationCenter)

Initializes and returns a notification queue for the specified notification center.

Managing Notifications

func enqueue(Notification, postingStyle: NotificationQueue.PostingStyle)

Adds a notification to the notification queue with a specified posting style.

func enqueue(Notification, postingStyle: NotificationQueue.PostingStyle, coalesceMask: NotificationQueue.NotificationCoalescing, forModes: [RunLoopMode]?)

Adds a notification to the notification queue with a specified posting style, criteria for coalescing, and runloop mode.

func dequeueNotifications(matching: Notification, coalesceMask: Int)

Removes all notifications from the queue that match a provided notification using provided matching criteria.

Constants

NotificationQueue.NotificationCoalescing

These constants specify how notifications are coalesced.

NotificationQueue.PostingStyle

These constants specify when notifications are posted.

Relationships

Inherits From

Conforms To