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 и позже.