Ссылка ABMultiValue

Наследование

Не применимый

Соответствует

Не применимый

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

Swift

import AddressBook

Objective C

@import AddressBook;

ABMultiValue непрозрачный тип (чьи объекты известны как мультизначения) реализует свойство, которое может иметь многократные значения. Все содержавшие значения должны иметь тот же тип. Каждое значение имеет уникальный идентификатор и групповую метку, которая может быть одной из предоставленных меток или одного определенного пользователем.

Например, если свойство мультизначения используется для хранения телефонных номеров, могут быть многократные числа рабочего телефона. Они имеют ту же метку, но различные уникальные идентификаторы.

Свойства мультизначения являются неизменными. Для использования непостоянных свойств мультизначения посмотрите Ссылку ABMutableMultiValue.

Функции

Получение значений и меток


    
    ABMultiValueCopyValueAtIndex (_: _:)
    ABMultiValueCopyValueAtIndex

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

Объявление

Swift

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

Objective C

CFTypeRef ABMultiValueCopyValueAtIndex ( ABMultiValueRef multiValue, CFIndex index );

Параметры

`multiValue`	Свойство мультизначения, из которого можно получить значение.
`index`	Расположение требуемого значения в `multiValue`. Повышает исключение когда за пределы.

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

Значение в index в multiValue.

Обсуждение

Эта функция берет индекс. Если у Вас есть идентификатор, используйте ABMultiValueGetIndexForIdentifier функция для получения соответствующего индекса.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.

ABMultiValueCopyArrayOfAllValues (_:) ABMultiValueCopyArrayOfAllValues

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

Объявление

Swift

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

Objective C

CFArrayRef ABMultiValueCopyArrayOfAllValues ( ABMultiValueRef multiValue );

Параметры

multiValue

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

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

Массив, содержащий значения в multiValue.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.
ABMultiValueGetCount (_:) ABMultiValueGetCount

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

Объявление

Swift

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

Objective C

CFIndex ABMultiValueGetCount ( ABMultiValueRef multiValue );

Параметры

multiValue

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

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

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

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.


    
    ABMultiValueGetFirstIndexOfValue (_: _:)
    ABMultiValueGetFirstIndexOfValue

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

Объявление

Swift

func ABMultiValueGetFirstIndexOfValue(_ multiValue: ABMultiValue!, _ value: AnyObject!) -> CFIndex

Objective C

CFIndex ABMultiValueGetFirstIndexOfValue ( ABMultiValueRef multiValue, CFTypeRef value );

Параметры

`multiValue`	Свойство мультизначения, в котором можно искать `value`.
`value`	Значение для поиска в `multiValue`.

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

Расположение value в multiValue, -1 если value не присутствует в multiValue.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.


    
    ABMultiValueCopyLabelAtIndex (_: _:)
    ABMultiValueCopyLabelAtIndex

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

Объявление

Swift

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

Objective C

CFStringRef ABMultiValueCopyLabelAtIndex ( ABMultiValueRef multiValue, CFIndex index );

Параметры

`multiValue`	Свойство мультизначения со значением, чья метка для возврата.
`index`	Расположение значения в `multiValue` чью метку для возврата. Повышает исключение когда за пределы.

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

Метка для значения в index в multiValue.

Обсуждение

Если нет никакой метки для значения в index, возвраты NULL.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.

Получение идентификаторов значения


    
    ABMultiValueGetIdentifierAtIndex (_: _:)
    ABMultiValueGetIdentifierAtIndex

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

Объявление

Swift

func ABMultiValueGetIdentifierAtIndex(_ multiValue: ABMultiValue!, _ index: CFIndex) -> ABMultiValueIdentifier

Objective C

ABMultiValueIdentifier ABMultiValueGetIdentifierAtIndex ( ABMultiValueRef multiValue, CFIndex index );

Параметры

`multiValue`	Свойство мультизначения с идентификатором для возврата.
`index`	Расположение значения в `multiValue` чей идентификатор возвращается.

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

Идентификатор значения в index в multiValue.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.


    
    ABMultiValueGetIndexForIdentifier (_: _:)
    ABMultiValueGetIndexForIdentifier

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

Объявление

Swift

func ABMultiValueGetIndexForIdentifier(_ multiValue: ABMultiValue!, _ identifier: ABMultiValueIdentifier) -> CFIndex

Objective C

CFIndex ABMultiValueGetIndexForIdentifier ( ABMultiValueRef multiValue, ABMultiValueIdentifier identifier );

Параметры

`multiValue`	Свойство мультизначения, в котором можно искать `identifier` идентификатор значения.
`identifier`	Идентификатор значения, чье расположение в `multiValue` возвращается.

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

Расположение в multiValue это содержит значение с identifier как его идентификатор.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.

Получение информации свойства

ABMultiValueGetPropertyType (_:) ABMultiValueGetPropertyType

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

Объявление

Swift

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

Objective C

ABPropertyType ABMultiValueGetPropertyType ( ABMultiValueRef multiValue );

Параметры

multiValue

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

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

Тип значений, содержавшихся в multiValue или kABInvalidPropertyType когда multiValue пусто или содержит значения различных типов.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.

См. также

ABMultiValueCreateMutable

Типы данных

ABMultiValueRef

Ссылка на свойство мультизначения.

Объявление

Swift

typealias ABMultiValueRef = ABMultiValue

Objective C

typedef CFTypeRef ABMultiValueRef;

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.
ABMultiValueIdentifier

Идентифицирует свойства мультизначения.

Объявление

Swift

typealias ABMultiValueIdentifier = Int32

Objective C

typedef int32_t ABMultiValueIdentifier;

Обсуждение

Посмотрите “Invalid Multivalue-Property Identifier”.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в iOS 2.0 и позже.

Константы

Недопустимый идентификатор свойства мультизначения
Это определение препроцессора идентифицирует свойство мультизначения со значениями, тип которых не соответствует свой заявленный тип.

Объявление

Swift

var kABMultiValueInvalidIdentifier: Int32 { get }

Objective C

#define kABMultiValueInvalidIdentifier -1

Константы
- kABMultiValueInvalidIdentifier
  
  Недопустимое свойство мультизначения.
  
  Доступный в iOS 2.0 и позже.
Обсуждение

Посмотрите ABMultiValueIdentifier.

Ссылка ABMultiValue

Функции

Получение значений и меток

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление

Параметры

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

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

Доступность

Объявление

Параметры

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

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

Доступность

Объявление

Параметры

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

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

Получение идентификаторов значения

Объявление

Параметры

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

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

Доступность

Объявление

Параметры

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

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

Доступность

Получение информации свойства

Объявление

Параметры

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

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

Доступность

См. также

Типы данных

Объявление

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

Доступность

Объявление

Обсуждение

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

Доступность

Константы

Объявление

Константы

Обсуждение