Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылочная ссылка ABSearchElement C платформы AddressBook

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка ABSearchElement C

ABSearchElement используется для указания поискового запроса для записей в базе данных Address Book.

Можно создать простой запрос путем создания объекта ABSearchElement, использующего любого ABGroupCreateSearchElement или ABPersonCreateSearchElement функция для соответствующей записи. Тогда Вы используете ABAddressBook ABCopyArrayOfMatchingValues функция, передавая ABSearchElement как параметр, для запросов базы данных.

ABSearchElement также обеспечивает функцию для создания составных запросов. Используйте ABSearchElementCreateWithConjunction функционируйте для объединения двух простых или сложных запросов в составной запрос с помощью любого kABSearchAnd или kABSearchOr константы соединения.

Используйте ABSearchElementMatchesRecord функционируйте, чтобы протестировать, соответствует ли определенная запись запрос.

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

Функции

  • Возвращает составной поисковый элемент, создаваемый путем объединения поисковых элементов в массиве с данным соединением.

    Объявление

    Swift

    func ABSearchElementCreateWithConjunction(_ conjunction: ABSearchConjunction, _ children: CFArray!) -> Unmanaged<ABSearchElement>!

    Objective C

    ABSearchElementRef ABSearchElementCreateWithConjunction ( ABSearchConjunction conjunction, CFArrayRef childrenSearchElement );

    Параметры

    conjunction

    Соединение раньше присоединялось к поисковым элементам в children. Может быть также kABSearchAnd или kABSearchOr.

    children

    Массив, содержащий ABSearchElement, возражает, чтобы быть присоединенным с помощью conjunction. Если NULL эта функция повышает исключение.

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

    Новый составной поисковый элемент, присоединяющийся к поисковым элементам в children использование conjunction. Вы ответственны за выпуск этого объекта.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

  • Тесты, соответствует ли запись поисковый элемент.

    Объявление

    Swift

    func ABSearchElementMatchesRecord(_ searchElement: ABSearchElement!, _ record: ABRecordRef) -> Bool

    Objective C

    bool ABSearchElementMatchesRecord ( ABSearchElementRef searchElement, ABRecordRef record );

    Параметры

    searchElement

    Поисковый элемент, содержащий запрос, Вы хотите протестировать record с.

    record

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

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

    Возвраты true если record параметр удовлетворяет условия в searchElement, false иначе.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

Типы данных

  • Ссылка на объект ABSearchElement.

    Объявление

    Swift

    typealias ABSearchElementRef = ABSearchElement

    Objective C

    typedef struct __ABSearchElementRef *ABSearchElementRef;

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

Константы

  • Константы раньше указывали тип сделанного сравнения.

    Объявление

    Swift

    typealias ABSearchComparison = CFIndex

    Objective C

    enum ABSearchComparison { kABEqual, kABNotEqual, kABLessThan, kABLessThanOrEqual, kABGreaterThan, kABGreaterThanOrEqual, kABEqualCaseInsensitive, kABContainsSubString, kABContainsSubStringCaseInsensitive, kABPrefixMatch, kABPrefixMatchCaseInsensitive, kABBitsInBitFieldMatch, kABDoesNotContainSubString, kABDoesNotContainSubStringCaseInsensitive, kABNotEqualCaseInsensitive, kABSuffixMatch, kABSuffixMatchCaseInsensitive, kABWithinIntervalAroundToday, kABWithinIntervalAroundTodayYearless, kABNotWithinIntervalAroundToday, kABNotWithinIntervalAroundTodayYearless, kABWithinIntervalFromToday, kABWithinIntervalFromTodayYearless, kABNotWithinIntervalFromToday, kABNotWithinIntervalFromTodayYearless };

    Константы

    • kABEqual

      kABEqual

      Поиск элементов, которые равны значению.

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

    • kABNotEqual

      kABNotEqual

      Поиск элементов, которые не равны значению.

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

    • kABNotEqualCaseInsensitive

      kABNotEqualCaseInsensitive

      Поиск элементов, которые не равны значению, игнорируя регистр.

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

    • kABLessThan

      kABLessThan

      Поиск элементов, которые являются меньше, чем значение.

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

    • kABLessThanOrEqual

      kABLessThanOrEqual

      Поиск элементов, которые меньше чем или равны значению.

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

    • kABGreaterThan

      kABGreaterThan

      Поиск элементов, которые больше, чем значение.

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

    • kABGreaterThanOrEqual

      kABGreaterThanOrEqual

      Поиск элементов, которые больше, чем или равны значению.

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

    • kABEqualCaseInsensitive

      kABEqualCaseInsensitive

      Поиск элементов, которые равны значению, игнорируя регистр.

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

    • kABContainsSubString

      kABContainsSubString

      Поиск элементов, содержащих значение.

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

    • kABContainsSubStringCaseInsensitive

      kABContainsSubStringCaseInsensitive

      Поиск элементов, содержащих значение, игнорируя регистр.

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

    • kABPrefixMatch

      kABPrefixMatch

      Поиск элементов, начинающихся со значения.

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

    • kABPrefixMatchCaseInsensitive

      kABPrefixMatchCaseInsensitive

      Поиск элементов, начинающихся со значения, игнорируя регистр.

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

    • kABSuffixMatch

      kABSuffixMatch

      Поиск элементов, заканчивающихся значением.

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

    • kABSuffixMatchCaseInsensitive

      kABSuffixMatchCaseInsensitive

      Поиск элементов, заканчивающихся значением, игнорируя регистр.

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

    • kABBitsInBitFieldMatch

      kABBitsInBitFieldMatch

      Поиск элементов, соответствующих биты в ABPersonFlags.

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

    • kABDoesNotContainSubString

      kABDoesNotContainSubString

      Поиск элементов, не содержащих значение.

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

    • kABDoesNotContainSubStringCaseInsensitive

      kABDoesNotContainSubStringCaseInsensitive

      Поиск элементов, не содержащих значение, игнорируя регистр.

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

    • kABWithinIntervalAroundToday

      kABWithinIntervalAroundToday

      Поиск элементов, которые являются во временном интервале (в секундах) вперед или назад с сегодняшнего дня.

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

    • kABWithinIntervalAroundTodayYearless

      kABWithinIntervalAroundTodayYearless

      Поиск элементов, которые являются во временном интервале (в секундах) вперед или назад от этого дня в любом году.

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

    • kABNotWithinIntervalAroundToday

      kABNotWithinIntervalAroundToday

      Поиск элементов, которые не являются во временном интервале (в секундах) вперед или назад с сегодняшнего дня.

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

    • kABNotWithinIntervalAroundTodayYearless

      kABNotWithinIntervalAroundTodayYearless

      Поиск элементов, которые не являются во временном интервале (в секундах) вперед или назад от этого дня ни в каком году.

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

    • kABWithinIntervalFromToday

      kABWithinIntervalFromToday

      Поиск элементов, которые являются во временном интервале (в секундах) вперед с сегодняшнего дня.

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

    • kABWithinIntervalFromTodayYearless

      kABWithinIntervalFromTodayYearless

      Поиск элементов, которые являются во временном интервале (в секундах) вперед от этого дня в любом году.

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

    • kABNotWithinIntervalFromToday

      kABNotWithinIntervalFromToday

      Поиск элементов, которые не являются во временном интервале (в секундах) вперед с сегодняшнего дня.

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

    • kABNotWithinIntervalFromTodayYearless

      kABNotWithinIntervalFromTodayYearless

      Поиск элементов, которые не являются во временном интервале (в секундах) вперед от этого дня ни в каком году.

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

    Обсуждение

    Эти константы привыкли в вызове к ABGroupCreateSearchElement или ABPersonCreateSearchElement функция для указания типа сделанного сравнения.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

  • Константы раньше создавали составные поисковые элементы.

    Объявление

    Swift

    typealias ABSearchConjunction = CFIndex

    Objective C

    enum ABSearchConjunction { kABSearchAnd = 0, kABSearchOr = 1 };

    Константы

    • kABSearchAnd

      kABSearchAnd

      Присоединитесь к поисковым элементам вместе с операндом AND.

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

    • kABSearchOr

      kABSearchOr

      Присоединитесь к поисковым элементам вместе с операндом OR.

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

    Обсуждение

    Эти константы используются для создания составных поисковых элементов с ABSearchElementCreateWithConjunction функция.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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