<!--
{
  "availability" : [
    "iOS: 2.0.0 - 9.0.0",
    "iPadOS: 2.0.0 - 9.0.0",
    "macCatalyst: 13.1.0 - 13.1.0"
  ],
  "documentType" : "symbol",
  "framework" : "AddressBook",
  "identifier" : "/documentation/AddressBook/ABMultiValueAddValueAndLabel(_:_:_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Address Book"
    ],
    "preciseIdentifier" : "c:@F@ABMultiValueAddValueAndLabel"
  },
  "title" : "ABMultiValueAddValueAndLabel(_:_:_:_:)"
}
-->

# ABMultiValueAddValueAndLabel(_:_:_:_:)

Adds a value and its corresponding label to a multivalue property.

```
func ABMultiValueAddValueAndLabel(_ multiValue: ABMutableMultiValue!, _ value: CFTypeRef!, _ label: CFString!, _ outIdentifier: UnsafeMutablePointer<ABMultiValueIdentifier>!) -> Bool
```

## Parameters

`multiValue`

The multivalue property to add `value` and `label` to.

`value`

The value to add to `multiValue`.

`label`

The label for `value`.

`outIdentifier`

The address at which to place the identifier of the added value. Pass `NULL` to ignore the identifier.

## Return Value

`true` when value is added to multiValue successfully, `false` otherwise.

## Discussion

This function performs no type checking. It allows the addition of values whose type does not match the type declared for `multiValue`.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)