add(_:withLabel:)
Adds a value and its label to a multivalue list.
Declaration
func add(_ value: Any!, withLabel label: String!) -> String!Parameters
- value:
The value to add.
- label:
The label to associate with the value.
Return Value
The new identifier if value is added successfully; otherwise, nil.
Discussion
The value argument must be of the correct type. For example, if the receiver is the value for a property of type kABMultiStringProperty, then value needs to be an NSString object. See Property Types for a list of supported types in a multivalue list (see descriptions of the kABMulti... constants). If either the value or the label argument is nil, this method raises an exception.
This method performs no type checking and will let you add a value whose type does not match the types of the other values in the list. However, if you try to use a multivalue list whose values are not all of the same type, other methods, such as the ABRecord setValue(_:forProperty:) method, will return false or kABErrorInProperty.