---
title: ABMutableMultiValue
framework: addressbook
role: symbol
role_heading: Class
path: addressbook/abmutablemultivalue
---

# ABMutableMultiValue

A mutable representation of a property that might have multiple values.

## Declaration

```swift
class ABMutableMultiValue
```

## Overview

Overview Each value in a multivalue list must be of the same type, and must have an associated predefined or user-defined label, and unique identifier. The labels, however, need not be unique. For example, you can have multiple Home phone numbers. Each multivalue object may have a primary identifier—used as a default value when a label is not provided. For example, a person record may have multiple addresses with the labels Home and Work, where Work is designated as the primary value. Instances of ABMutableMultiValue are mutable, see ABMultiValue for additional methods that access the content of a multivalue list. The ABMutableMultiValue class is “toll-free bridged” with its procedural C opaque-type counterpart. This means that the ABMutableMultiValue type is interchangeable in function or method calls with instances of the ABMutableMultiValue class.

## Topics

### Adding a value

- [add(_:withLabel:)](addressbook/abmutablemultivalue/add(_:withlabel:).md)
- [insert(_:withLabel:at:)](addressbook/abmutablemultivalue/insert(_:withlabel:at:).md)

### Replacing values and labels

- [replaceLabel(at:withLabel:)](addressbook/abmutablemultivalue/replacelabel(at:withlabel:).md)
- [replace(at:withValue:)](addressbook/abmutablemultivalue/replace(at:withvalue:).md)

### Removing values

- [removeAndLabel(at:)](addressbook/abmutablemultivalue/removeandlabel(at:).md)

### Setting the Primary identifier

- [setPrimaryIdentifier(_:)](addressbook/abmutablemultivalue/setprimaryidentifier(_:).md)

## Relationships

### Inherits From

- [ABMultiValue](addressbook/abmultivalue.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCopying](foundation/nscopying.md)
- [NSFastEnumeration](foundation/nsfastenumeration.md)
- [NSMutableCopying](foundation/nsmutablecopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Data Types

- [ABPerson](addressbook/abperson.md)
- [ABGroup](addressbook/abgroup.md)
- [ABMultiValue](addressbook/abmultivalue.md)
- [ABImageClient](addressbook/abimageclient.md)
- [ABRecord](addressbook/abrecord.md)