Addressbook.multivalue.insertValue
----------------------------------

Inserts a value and its label at the given index in a multivalue list.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Addressbook](component_Addressbook.md) | [3.1](newinversion31.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

### Deprecated

This function was [deprecated](deprecated.md). Use [Contacts](component_Contacts.md) functions instead.

MBS( "Addressbook.multivalue.insertValue"; Value; Label; Index ) 

**MBS**( **"Addressbook.multivalue.insertValue";** /\* Inserts a value and its label at the given index in a multivalue list. \*/  
**$Value**; /\* The value to add. \*/   
**$Label**; /\* The label to associate with the value. \*/   
**$Index**) /\* The index where the value will be inserted. \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Value | The value to add. | $value |
| Label | The label to associate with the value. | $label |
| Index | The index where the value will be inserted. | $index |

### Result

Returns identifier or error.

### Description

Inserts a value and its label at the given index in a multivalue list.  
Returns the identifier of the inserted value and label if they are added successfully; otherwise, empty result.  
If either the value or the label is empty or if the index is out of bounds, this method returns an error.  
  
Possible labels are:  
kABHomePageLabel, kABEmailWorkLabel, kABEmailHomeLabel, kABAddressHomeLabel, kABAddressWorkLabel, kABAnniversaryLabel, kABFatherLabel, kABMotherLabel, kABParentLabel, kABBrotherLabel, kABSisterLabel, kABChildLabel, kABFriendLabel, kABSpouseLabel, kABPartnerLabel, kABAssistantLabel, kABManagerLabel, kABPhoneWorkLabel, kABPhoneHomeLabel, kABPhoneiPhoneLabel, kABPhoneMobileLabel, kABPhoneMainLabel, kABPhoneHomeFAXLabel, kABPhoneWorkFAXLabel, kABPhonePagerLabel, kABAIMWorkLabel, kABAIMHomeLabel, kABJabberWorkLabel, kABJabberHomeLabel, kABMSNWorkLabel, kABMSNHomeLabel, kABYahooWorkLabel, kABYahooHomeLabel, kABICQWorkLabel, kABICQHomeLabel, kABWorkLabel, kABHomeLabel, kABOtherLabel or kABMobileMeLabel.  
### See also

- [Addressbook.multivalue.addValue](AddressbookmultivalueaddValue.md)
- [Addressbook.multivalue.identifiers](Addressbookmultivalueidentifiers.md)
- [Addressbook.multivalue.indexForLabel](AddressbookmultivalueindexForLabel.md)
- [Addressbook.multivalue.labelAtIndex](AddressbookmultivaluelabelAtIndex.md)
- [Addressbook.multivalue.valueAtIndex](AddressbookmultivaluevalueAtIndex.md)
- [Addressbook.multivalue.values](Addressbookmultivaluevalues.md)

This function checks for a license.

Created 18th August 2014 , last changed 18th August 2014

  
[Addressbook.multivalue.indexForLabel](AddressbookmultivalueindexForLabel.md) - [Addressbook.multivalue.labelAtIndex](AddressbookmultivaluelabelAtIndex.md)

[HTML Version](AddressbookmultivalueinsertValue.shtml)