Class

ABMultiValue

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

Declaration

@interface ABMultiValue : NSObject

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 ABMultiValueRef type is interchangeable in function or method calls with instances of the ABMultiValue class.

Topics

Accessing the primary identifier

- primaryIdentifier

Returns the identifier for the primary value.

Accessing identifiers

- identifierAtIndex:

Returns the identifier for the given index.

- indexForIdentifier:

Returns the index for the given identifier.

Accessing entries

- labelAtIndex:

Returns the label for the given index.

- valueAtIndex:

Returns the value for the given index.

- valueForIdentifier:

Returns the value for the given identifier.

- labelForIdentifier:

Returns the label for the given identifier.

Querying the list

- count

Returns the number of entries in a multivalue list.

- propertyType

Returns the type for the values in a multivalue list.

Relationships

Inherits From