Generic Class

NSMapTable

The NSMapTable class is a mutable collection modeled after NSDictionary, with the following differences:

Overview

  • The major option is to have keys and/or values held “weakly” in a manner that entries are removed when one of the objects is reclaimed.

  • Its keys or values may be copied on input or may use pointer identity for equality and hashing.

  • It can contain arbitrary pointers (its contents are not constrained to being objects).

    You can configure an NSMapTable instance to operate on arbitrary pointers and not just objects, although typically you are encouraged to use the C function API for void * pointers. (See Managing Map Tables for more information) The object-based API (such as setObject(_:forKey:)) will not work for non-object pointers without type-casting.

When configuring map tables, note that only the options listed in NSMapTableOptions guarantee that the rest of the API will work correctly—including copying, archiving, and fast enumeration. While other NSPointerFunctions options are used for certain configurations, such as to hold arbitrary pointers, not all combinations of the options are valid. With some combinations the map table may not work correctly, or may not even be initialized correctly.

Subclassing Notes

NSMapTable is not suitable for subclassing.

Symbols

Creating and Initializing a Map Table

class func strongToStrongObjects()

Returns a new map table object which has strong references to the keys and values.

class func weakToStrongObjects()

Returns a new map table object which has weak references to the keys and strong references to the values.

class func strongToWeakObjects()

Returns a new map table object which has strong references to the keys and weak references to the values.

class func weakToWeakObjects()

Returns a new map table object which has weak references to the keys and values.

Accessing Content

func object(forKey: KeyType?)

Returns a the value associated with a given key.

func keyEnumerator()

Returns an enumerator object that lets you access each key in the map table.

func objectEnumerator()

Returns an enumerator object that lets you access each value in the map table.

var count: Int

The number of key-value pairs in the map table.

Manipulating Content

func setObject(ObjectType?, forKey: KeyType?)

Adds a given key-value pair to the map table.

func removeObject(forKey: KeyType?)

Removes a given key and its associated value from the map table.

func removeAllObjects()

Empties the map table of its entries.

Creating a Dictionary Representation

func dictionaryRepresentation()

Returns a dictionary representation of the map table.

Accessing Pointer Functions

var keyPointerFunctions: NSPointerFunctions

The pointer functions the map table uses to manage keys.

var valuePointerFunctions: NSPointerFunctions

The pointer functions the map table uses to manage values.

Constants

NSMapTableOptions

Constants used as components in a bitfield to specify the behavior of elements (keys and values) in an NSMapTable object.

Relationships

Generic Constraints

  • KeyType : AnyObject
  • ObjectType : AnyObject

Inherits From