---
title: "NSMapInsert(_:_:_:)"
framework: foundation
role: symbol
role_heading: Function
path: "foundation/nsmapinsert(_:_:_:)"
---

# NSMapInsert(_:_:_:)

Inserts a key-value pair into the specified table.

## Declaration

```swift
func NSMapInsert(_ table: NSMapTable<AnyObject, AnyObject>, _ key: UnsafeRawPointer?, _ value: UnsafeRawPointer?)
```

## Discussion

Discussion Inserts key and value into table. If key matches a key already in table, value is retained and the previous value is released, using the retain and release callback functions that were specified when the table was created. Raises NSInvalidArgumentException if key is equal to the notAKeyMarker field of the table’s NSMapTableKeyCallBacks structure.

## See Also

### Related Documentation

- [NSMapInsertIfAbsent(_:_:_:)](foundation/nsmapinsertifabsent(_:_:_:).md)
- [NSMapRemove(_:_:)](foundation/nsmapremove(_:_:).md)
- [NSMapInsertKnownAbsent(_:_:_:)](foundation/nsmapinsertknownabsent(_:_:_:).md)

### Functions

- [NSAllMapTableKeys(_:)](foundation/nsallmaptablekeys(_:).md)
- [NSAllMapTableValues(_:)](foundation/nsallmaptablevalues(_:).md)
- [NSCompareMapTables(_:_:)](foundation/nscomparemaptables(_:_:).md)
- [NSCopyMapTableWithZone(_:_:)](foundation/nscopymaptablewithzone(_:_:).md)
- [NSCountMapTable(_:)](foundation/nscountmaptable(_:).md)
- [NSCreateMapTable(_:_:_:)](foundation/nscreatemaptable(_:_:_:).md)
- [NSCreateMapTableWithZone(_:_:_:_:)](foundation/nscreatemaptablewithzone(_:_:_:_:).md)
- [NSEndMapTableEnumeration(_:)](foundation/nsendmaptableenumeration(_:).md)
- [NSEnumerateMapTable(_:)](foundation/nsenumeratemaptable(_:).md)
- [NSFreeMapTable(_:)](foundation/nsfreemaptable(_:).md)
- [NSMapGet(_:_:)](foundation/nsmapget(_:_:).md)
- [NSMapInsertIfAbsent(_:_:_:)](foundation/nsmapinsertifabsent(_:_:_:).md)
- [NSMapInsertKnownAbsent(_:_:_:)](foundation/nsmapinsertknownabsent(_:_:_:).md)
- [NSMapMember(_:_:_:_:)](foundation/nsmapmember(_:_:_:_:).md)
- [NSMapRemove(_:_:)](foundation/nsmapremove(_:_:).md)