Ссылка 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) -> BoolObjective 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 и позже.
-