ABMultiValue
ABMultiValue и ABMutableMultiValue классы используются для представления свойств, которые могли бы иметь многократные значения. Каждое значение в списке мультизначения должно иметь тот же тип и должно было предопределить связанное или определяемую пользователем метку и уникальный идентификатор. Метки, однако, не должны быть уникальными. Например, у Вас могут быть многократные Домашние телефоны. Когда метка не предоставлена, каждый объект мультизначения может иметь основной идентификатор — используемый в качестве значения по умолчанию. Например, запись лица может иметь многократные адреса с метками Домой и Работой, где Работа определяется как основное значение. Экземпляры этого класса являются неизменными, видят ABMutableMultiValue для методов, управляющих содержанием списка мультизначения.
ABMultiValue класс “бесплатный соединенный мостом” с его процедурным дубликатом непрозрачного типа C. Это означает что ABMultiValueRef тип является взаимозаменяемым в вызовах функции или вызовах метода с экземплярами ABMultiValue класс.
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCopying -
NSFastEnumeration -
NSMutableCopying -
NSObjectProtocol -
Печатаемый -
NSCopying -
NSFastEnumeration -
NSMutableCopying -
NSObject
Оператор импорта
Swift
import AddressBook
Objective C
@import AddressBook;
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает идентификатор для основного значения.
Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
См. также
– indexForIdentifier:– setPrimaryIdentifier:(ABMutableMultiValue)
-
Возвращает идентификатор для данного индекса.
Объявление
Objective C
- (NSString *)identifierAtIndex:(NSUInteger)indexПараметры
indexИндекс идентификатора, который будет возвращен.
Обсуждение
Если
indexпараметр выходит за пределы, этот метод повышает исключение.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает индекс для данного идентификатора.
Объявление
Objective C
- (NSUInteger)indexForIdentifier:(NSString *)identifierПараметры
identifierИдентификатор, индекс которого будет возвращен.
Обсуждение
Если идентификатор не найден, возвраты
NSNotFound.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает метку для данного индекса.
Объявление
Objective C
- (NSString *)labelAtIndex:(NSUInteger)indexПараметры
indexИндекс для метки, которая будет возвращена.
Обсуждение
Если
indexпараметр выходит за пределы, этот метод повышает исключение.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает значение для данного индекса.
Объявление
Swift
func valueAtIndex(_index: Int) -> AnyObject!Objective C
- (id)valueAtIndex:(NSUInteger)indexПараметры
indexИндекс для значения, которое будет возвращено.
Обсуждение
Если
indexпараметр выходит за пределы, этот метод повышает исключение.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
См. также
-
Возвращает значение для данного идентификатора.
Объявление
Swift
func valueForIdentifier(_identifier: String!) -> AnyObject!Objective C
- (id)valueForIdentifier:(NSString *)identifierПараметры
identifierИдентификатор для значения, которое будет возвращено.
Обсуждение
Если идентификатор не найден, возвраты
nil.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает метку для данного идентификатора.
Объявление
Swift
func labelForIdentifier(_identifier: String!) -> AnyObject!Objective C
- (id)labelForIdentifier:(NSString *)identifierПараметры
identifierИдентификатор для метки, которая будет возвращена.
Обсуждение
Если идентификатор не найден, этот метод возвраты
nil.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.5 и позже.
См. также
-
Возвращает число записей в списке мультизначения.
Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
-
Возвращает тип для значений в списке мультизначения.
Обсуждение
Если список мультизначения пуст, или его значения имеют различные типы, он возвращается
kABErrorInProperty.Оператор импорта
Objective C
@import AddressBook;Swift
import AddressBookДоступность
Доступный в OS X v10.2 и позже.
