ABRecord C ссылка

ABRecord является абстрактным непрозрачным типом, обеспечивающим единый интерфейс для и определяющим общую собственность для всех записей в базе данных Address Book. Свойство является полем в записи базы данных, такой как имя или фамилия записи лица. ABRecord определяет типы свойств, поддерживаемых, и основные функции для получения, установки и удаления значений свойств.

Использовать ABRecordCopyValue для получения значения свойства записи использовать ABRecordSetValue установить значение, и ABRecordRemoveValue удалить значение.

Каждая запись в базе данных Address Book имеет полученное использование соответствующего уникального идентификатора ABRecordCopyUniqueId функция. Уникальный идентификатор используется другими функциями в платформе AddressBook.

Можно проверить, только ли запись для чтения при помощи ABRecordIsReadOnly функция.

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

Функции

ABRecord C разные функции

ABRecordCopyRecordType (_:) ABRecordCopyRecordType

Возвращает тип данной записи.

Объявление

Swift

func ABRecordCopyRecordType(_ record: ABRecordRef) -> Unmanaged<CFString>!

Objective C

CFStringRef ABRecordCopyRecordType ( ABRecordRef record );

Параметры

record

Запись, тип которой Вы хотите получить.

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

Тип record, один из kAB...RecordType константы. Вы ответственны за выпуск этого объекта.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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

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

Объявление

Swift

func ABRecordCopyUniqueId(_ record: ABRecordRef) -> Unmanaged<CFString>!

Objective C

CFStringRef ABRecordCopyUniqueId ( ABRecordRef record );

Параметры

record

Запись, уникальный идентификатор которой Вы хотите получить.

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

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

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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


    
    ABRecordCopyValue (_: _:)
    ABRecordCopyValue

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

Объявление

Swift

func ABRecordCopyValue(_ record: ABRecordRef, _ property: CFString!) -> Unmanaged<AnyObject>!

Objective C

CFTypeRef ABRecordCopyValue ( ABRecordRef record, CFStringRef property );

Параметры


      record

Запись, значение которой Вы хотите получить.


      property

Имя свойства в record чье значение Вы хотите получить. Может быть предопределенное или определенное с помощью программы свойство. Посмотрите Common Properties для списка свойств все записи имеют, и определенный ABRecord получил непрозрачные типы для любых дополнительных свойств.

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

Значение для property в record. Тип возвращенного значения зависит от типа свойства (см. Property Types для списка возможных типов свойства). Вы ответственны за выпуск этого объекта.

Если значение для property недопустимо, эта функция возвраты NULL.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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

ABRecordCreateCopy (_:) ABRecordCreateCopy

Возвращает копию данной записи.

Объявление

Swift

func ABRecordCreateCopy(_ record: ABRecordRef) -> ABRecordRef

Objective C

ABRecordRef ABRecordCreateCopy ( ABRecordRef record );

Параметры

record

Запись Вы хотите скопировать.

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

Копия указанного ABRecordRef.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.4 и позже.
ABRecordIsReadOnly (_:) ABRecordIsReadOnly

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

Объявление

Swift

func ABRecordIsReadOnly(_ record: ABRecordRef) -> Bool

Objective C

bool ABRecordIsReadOnly ( ABRecordRef record );

Параметры

record

Запись Вы хотите проверить.

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

true если запись только для чтения, false иначе.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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


    
    ABRecordRemoveValue (_: _:)
    ABRecordRemoveValue

Удаляет значение данного свойства.

Объявление

Swift

func ABRecordRemoveValue(_ record: ABRecordRef, _ property: CFString!) -> Bool

Objective C

bool ABRecordRemoveValue ( ABRecordRef record, CFStringRef property );

Параметры


      record

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


      property

Имя свойства в record чье значение Вы хотите удалить. Может быть предопределенное или определенное с помощью программы свойство. Посмотрите Common Properties для списка свойств все записи имеют, и определенный ABRecord получил непрозрачные типы для любых дополнительных свойств.

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

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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


    
    ABRecordSetValue (_: _: _:)
    ABRecordSetValue

Устанавливает значение данного свойства для записи.

Объявление

Swift

func ABRecordSetValue(_ record: ABRecordRef, _ property: CFString!, _ value: AnyObject!) -> Bool

Objective C

bool ABRecordSetValue ( ABRecordRef record, CFStringRef property, CFTypeRef value );

Параметры

`record`	Запись Вы хотите изменить.
`property`	Свойство, значение которого Вы хотите установить. Может быть предопределенное или определенное с помощью программы свойство. Посмотрите `Common Properties` для списка свойств все записи имеют, и определенный ABRecord получил непрозрачные типы для любых дополнительных свойств. Если `NULL`, эта функция повышает исключение.
`value`	Новое значение для `property` в `record`. Если `NULL` или не корректный тип, эта функция повышает исключение.

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

Если property свойство списка мультизначения, этот метод проверки, чтобы видеть, являются ли значения в списке мультизначения тем же типом. Если список мультизначения содержит смешанные типы, этот метод возвраты false. Возвраты true в случае успеха, false иначе.

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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

Типы данных

ABRecordRef ABRecordRef

Ссылка на ABRecord возражает или любой из его полученных непрозрачных типов.

Объявление

Swift

typealias ABRecordRef = UnsafeMutablePointer<Void>

Objective C

typedef void *ABRecordRef;

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

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

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

Константы

Общая собственность
Свойства, характерные для всех типов записи.

Объявление

Swift

let kABUIDProperty: NSString! let kABCreationDateProperty: NSString! let kABModificationDateProperty: NSString!

Objective C

CFStringRef kABUIDProperty; CFStringRef kABCreationDateProperty; CFStringRef kABModificationDateProperty

Константы
- kABUIDProperty
  
  kABUIDProperty
  
  Свойство UID.
  
  Доступный в OS X v10.2 и позже.
- kABCreationDateProperty
  
  kABCreationDateProperty
  
  Дата создания (когда сначала сохраненный).
  
  Доступный в OS X v10.2 и позже.
- kABModificationDateProperty
  
  kABModificationDateProperty
  
  Дата модификации (когда в последний раз сохраненный).
  
  Доступный в OS X v10.2 и позже.