---
title: ABMultiValue
framework: addressbook
role: symbol
role_heading: Class
path: addressbook/abmultivalue
---

# ABMultiValue

An immutable representation of a property that might have multiple values.

## Declaration

```swift
class ABMultiValue
```

## 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 this class are immutable, see ABMutableMultiValue for methods that manipulate the content of a multivalue list. The ABMultiValue class is “toll-free bridged” with its procedural C opaque-type counterpart. This means that the ABMultiValue type is interchangeable in function or method calls with instances of the ABMultiValue class.

## Topics

### Accessing the primary identifier

- [primaryIdentifier()](addressbook/abmultivalue/primaryidentifier().md)

### Accessing identifiers

- [identifier(at:)](addressbook/abmultivalue/identifier(at:).md)
- [index(forIdentifier:)](addressbook/abmultivalue/index(foridentifier:).md)

### Accessing entries

- [label(at:)](addressbook/abmultivalue/label(at:).md)
- [value(at:)](addressbook/abmultivalue/value(at:).md)
- [value(forIdentifier:)](addressbook/abmultivalue/value(foridentifier:).md)
- [label(forIdentifier:)](addressbook/abmultivalue/label(foridentifier:).md)

### Querying the list

- [count()](addressbook/abmultivalue/count().md)
- [propertyType()](addressbook/abmultivalue/propertytype().md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Inherited By

- [ABMutableMultiValue](addressbook/abmutablemultivalue.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)
- [ABMutableMultiValue](addressbook/abmutablemultivalue.md)
- [ABImageClient](addressbook/abimageclient.md)
- [ABRecord](addressbook/abrecord.md)