Ссылка ABMultiValue C

ABMultiValue и ABMutableMultiValue, непрозрачные типы используются для представления свойств, которые могли бы иметь многократные значения. Каждое значение в списке мультизначения должно быть тем же типом и предопределило связанное или определяемую пользователем метку и уникальный идентификатор. Метки, однако, не должны быть уникальными. Например, у Вас могут быть многократные «Домашние» телефонные номера. Когда метка не предоставлена, каждый объект мультизначения может иметь основной идентификатор — привыкший к поиску значение по умолчанию. Например, запись лица может иметь многократные адреса с метками «Домой» и «Работой», где «Работа» определяется как основное значение. Экземпляры этого класса являются неизменными, видят ABMutableMultiValue для функций, управляющих содержанием списка мультизначения.

Можно получить доступ к значениям с помощью числового индекса (подобный массиву). Используйте ABMultiValueCopyIdentifierAtIndex функция для получения идентификатора, ABMultiValueCopyLabelAtIndex функция для получения метки, и ABMultiValueCopyValueAtIndex функция для получения значения. Однако числовой индекс является временным, так как может измениться список мультизначения. Каждое значение или запись в списке мультизначения имеют уникальный идентификатор, который может использоваться для сохранения ссылки на определенное значение — идентификатор, как гарантируют, никогда не не изменится.

Используйте ABMultiValueCopyPrimaryIdentifier функция для получения основного идентификатора (идентификатор связался с основным значением).

ABMultiValue непрозрачный тип “бесплатный соединенный мостом” с его дубликатом Objective C. Это означает что ABMultiValueRef тип является взаимозаменяемым в вызовах функции или вызовах метода с экземплярами класса ABMultiValue.

Функции

ABMultiValue для разных функций C


    
    ABMultiValueCopyIdentifierAtIndex (_: _:)
    ABMultiValueCopyIdentifierAtIndex

Возвращает идентификатор в данном индексе.

Объявление

Swift

func ABMultiValueCopyIdentifierAtIndex(_ multiValue: ABMultiValue!, _ index: CFIndex) -> Unmanaged<CFString>!

Objective C

CFStringRef ABMultiValueCopyIdentifierAtIndex ( ABMultiValueRef multiValue, CFIndex index );

Параметры

`multiValue`	Список мультизначения, к которому Вы хотите получить доступ.
`index`	Индекс идентификатора Вы хотите получить. Если этот параметр выходит за пределы, эта функция повышает исключение.

Возвращаемое значение

Идентификатор в index в multiValue. Вы ответственны за выпуск этого объекта.

Обсуждение

Каждое значение в списке мультизначения должно быть тем же типом и предопределило связанное или определяемую пользователем метку и уникальный идентификатор. Используйте ABMultiValueCopyLabelAtIndex функция для получения метки, и ABMultiValueCopyValueAtIndexфункция для получения значения.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.


    
    ABMultiValueCopyLabelAtIndex (_: _:)
    ABMultiValueCopyLabelAtIndex

Возвращает метку для данного индекса.

Объявление

Swift

func ABMultiValueCopyLabelAtIndex(_ multiValue: ABMultiValue!, _ index: CFIndex) -> Unmanaged<CFString>!

Objective C

CFStringRef ABMultiValueCopyLabelAtIndex ( ABMultiValueRef multiValue, CFIndex index );

Параметры

`multiValue`	Список мультизначения, к которому Вы хотите получить доступ.
`index`	Индекс идентификатора Вы хотите получить. Если этот параметр выходит за пределы, эта функция повышает исключение.

Возвращаемое значение

Метка в index в multiValue. Вы ответственны за выпуск этого объекта.

Обсуждение

Каждое значение в списке мультизначения должно быть тем же типом и предопределило связанное или определяемую пользователем метку и уникальный идентификатор. Используйте ABMultiValueCopyIdentifierAtIndex функция для получения идентификатора, и ABMultiValueCopyValueAtIndexфункция для получения значения.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

ABMultiValueCopyPrimaryIdentifier (_:) ABMultiValueCopyPrimaryIdentifier

Возвращает идентификатор для основного значения.

Объявление

Swift

func ABMultiValueCopyPrimaryIdentifier(_ multiValue: ABMultiValue!) -> Unmanaged<CFString>!

Objective C

CFStringRef ABMultiValueCopyPrimaryIdentifier ( ABMultiValueRef multiValue );

Параметры

multiValue

Список мультизначения, к которому Вы хотите получить доступ.

Возвращаемое значение

Уникальный идентификатор для основного значения. Вы ответственны за выпуск этого объекта.

Обсуждение

Используйте ABMultiValueCopyIdentifierAtIndex функция для получения индекса для возвращенного идентификатора, и ABMultiValueCopyValueAtIndexфункция для получения ее значения.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.


    
    ABMultiValueCopyValueAtIndex (_: _:)
    ABMultiValueCopyValueAtIndex

Возвращает значение для данного индекса.

Объявление

Swift

func ABMultiValueCopyValueAtIndex(_ multiValue: ABMultiValue!, _ index: CFIndex) -> Unmanaged<AnyObject>!

Objective C

CFTypeRef ABMultiValueCopyValueAtIndex ( ABMultiValueRef multiValue, CFIndex index );

Параметры

`multiValue`	Список мультизначения, к которому Вы хотите получить доступ.
`index`	Индекс идентификатора Вы хотите получить. Если этот параметр выходит за пределы, эта функция повышает исключение.

Возвращаемое значение

Значение в index в multiValue. Вы ответственны за выпуск этого объекта.

Обсуждение

Каждое значение в списке мультизначения должно быть тем же типом и предопределило связанное или определяемую пользователем метку и уникальный идентификатор. Используйте ABMultiValueCopyIdentifierAtIndex функция для получения идентификатора, и ABMultiValueCopyLabelAtIndexфункция для получения метки.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

ABMultiValueCount (_:) ABMultiValueCount

Возвращает число записей в списке мультизначения.

Объявление

Swift

func ABMultiValueCount(_ multiValue: ABMultiValue!) -> CFIndex

Objective C

CFIndex ABMultiValueCount ( ABMultiValueRef multiValue );

Параметры

multiValue

Список мультизначения, к которому Вы хотите получить доступ.

Возвращаемое значение

Число записей в multiValue.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.
ABMultiValueCreate () ABMultiValueCreate

Возвращает новый объект ABMultiValue.

Объявление

Swift

func ABMultiValueCreate() -> Unmanaged<ABMultiValue>!

Objective C

ABMultiValueRef ABMultiValueCreate ( void );

Возвращаемое значение

Новый объект ABMultiValue. Вы ответственны за выпуск этого объекта.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.


    
    ABMultiValueCreateCopy (_:)
    ABMultiValueCreateCopy

Возвращает копию объекта мультизначения.

Объявление

Swift

func ABMultiValueCreateCopy(_ multiValue: ABMultiValue!) -> Unmanaged<ABMultiValue>!

Objective C

ABMultiValueRef ABMultiValueCreateCopy ( ABMultiValueRef multiValue );

Параметры


      multiValue

Объект мультизначения Вы хотите скопировать. Вы ответственны за выпуск этого объекта.

Возвращаемое значение

Копия multiValue.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

ABMultiValueCreateMutableCopy (_:) ABMultiValueCreateMutableCopy

Возвращает непостоянную копию объекта мультизначения.

Объявление

Swift

func ABMultiValueCreateMutableCopy(_ multiValue: ABMultiValue!) -> Unmanaged<ABMutableMultiValue>!

Objective C

ABMutableMultiValueRef ABMultiValueCreateMutableCopy ( ABMultiValueRef multiValue );

Параметры

multiValue

Объект мультизначения Вы хотите скопировать.

Возвращаемое значение

Непостоянная копия multiValue. Вы ответственны за выпуск этого объекта.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.


    
    ABMultiValueIndexForIdentifier (_: _:)
    ABMultiValueIndexForIdentifier

Возвращает индекс для данного идентификатора.

Объявление

Swift

func ABMultiValueIndexForIdentifier(_ multiValue: ABMultiValue!, _ identifier: CFString!) -> CFIndex

Objective C

CFIndex ABMultiValueIndexForIdentifier ( ABMultiValueRef multiValue, CFStringRef identifier );

Параметры

`multiValue`	Список мультизначения, к которому Вы хотите получить доступ.
`identifier`	Идентификатор, индекс которого Вы хотите получить.

Возвращаемое значение

Индекс identifier.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

ABMultiValuePropertyType (_:) ABMultiValuePropertyType

Возвращает тип для значений в списке мультизначения.

Объявление

Swift

func ABMultiValuePropertyType(_ multiValue: ABMultiValue!) -> ABPropertyType

Objective C

ABPropertyType ABMultiValuePropertyType ( ABMultiValueRef multiValue );

Параметры

multiValue

Список мультизначения, тип свойства которого Вы хотите получить.

Возвращаемое значение

Тип свойства multiValue. Если список пуст, или его значения имеют различные типы, возвраты kABErrorInProperty.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

Типы данных

ABMultiValueRef ABMultiValueRef

Ссылка на объект ABMultiValue или ABMutableMultiValue.

Объявление

Swift

typealias ABMultiValueRef = ABMultiValue

Objective C

typedef const struct __ABMultiValue *ABMultiValueRef;

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.