CKQuery

Правила предиката для объектов запроса

Предикаты, которые Вы создаете для своих объектов запроса, должны соблюсти эти правила:

• Предикаты основываются на строке формата. Вы не можете использовать значение или основанные на блоке предикаты.

• Предикаты используют только операторов, перечисленных в Таблице 1.

• Предикаты воздействуют только на поля, содержащие следующие типы данных:

  • NSString

  • NSDate

  • NSNumber

  • NSArray

  • CKReference

  • CLLocation

• Ключевые имена, используемые в предикатах, соответствуют полям в в настоящее время оцениваемой записи. Ключевые имена могут включать имена свойств метаданных записи такой как»creationDate” или любые поля данных Вы добавили к записи. Вы не можете использовать ключевые пути для указания полей в связанных записях.

• Предикаты поддерживают следующие строки подстановки переменных:

  • Использовать %@ для объектов значения, таких как строки, числа и даты.

  • Использовать %K для имени поля. Эта переменная замены указывает, что строка, которой заменяют, должна использоваться для поиска имени поля.

• За одним исключением, CONTAINS оператор может использоваться только для тестирования членства в списке. Исключение - при использовании его для выполнения полнотекстовых поисков в сочетании с self ключевой путь. self ключевой путь заставляет сервер выглядеть в доступных для поиска основанных на операция со строками полях для указанной строки маркера. Например, строка предиката @"self contains 'blue'" поиски слова, «синего» во всех полях, отмечены для включения в полнотекстовые поиски. Вы не можете использовать self ключевой путь для поиска в полях, тип которых не является строкой.

• ANY и SOME агрегатные операторы могут быть объединены с IN и CONTAINS операторы для выполнения тестов членства в списке.

• distanceToLocation:fromLocation: функция оператора выполняет основанное на радиусе сравнение расположения, и то сравнение должно определить, является ли значение расположения в круговой области, которую Вы обеспечиваете. Вы не можете использовать его для поиска расположений за пределами указанной круговой области.

• ALL агрегатный оператор не поддерживается.

• NOT составной оператор не поддерживается в следующих случаях:

  • Вы не можете использовать его для отрицания AND составной предикат.

  • Вы не можете использовать его в маркируемых запросах такой как self CONTAINS 'value'.

  • Вы не можете использовать его с distanceToLocation:fromLocation: функция.

  • Вы не можете использовать его в BETWEEN запросы.

Поддерживаемые операторы предиката

Таблица 1 перечисляет операторов, которых можно использовать в предикатах, связанных с a CKQuery объект.

Указание неподдерживаемого оператора или типа данных в предикате Вашего запроса приводит к ошибке при выполнении запроса. Для получения дополнительной информации о создании объектов предиката, см. Руководство по программированию Предиката.

Демонстрационные строки формата предиката

Для соответствия записей, соединяющихся с различной записью, ID которой Вы знаете создайте предикат, соответствующий поле, содержащее ссылочный объект как показано в Перечислении 1. В примере, employee поле записи содержит a CKReference возразите что точки против другой записи. Когда запрос выполняется, соответствие происходит когда ID в локально создаваемый CKReference объектом является тот же ID, найденный в указанном поле записи.

Для соответствия содержания поля к определенному значению используйте предикат, подобный тем показанным в Перечислении 2. Все перечисленные предикаты генерируют тот же набор результатов, в примере означающий что favoriteColors поле содержит значение red. Значение в поле должно соответствовать значение, которое Вы указываете в предикате точно. Основанные на операция со строками сравнения нечувствительны к регистру, но иначе все сравнения должны быть точным совпадением указанного значения.

Можно соответствовать против больше чем одного значения за один раз при помощи предиката, подобного тем в Перечислении 3. В примере предикаты сообщают о соответствии если значение в favoriteColor поле записи соответствует любое из значений red или green.

Для полей, содержащих строковые значения, можно соответствовать начинающуюся часть строки с помощью BEGINSWITH оператор как показано в Перечислении 4. Вы не можете использовать других операторов сравнения строк такой как CONTAINS или ENDSWITH. При использовании этого оператора поле должно содержать строковое значение и должно запуститься со строки, которую Вы указали. Соответствия нечувствительны к регистру. В примерах предикат соответствует записи чей favoriteColors поле содержало строки red, reddish, или red green duct tape.

Для выполнения маркируемого поиска полей записи используйте специальный оператор self. Маркируемый поиск ищет любые поля, которым включили полнотекстовый поиск, который является всеми основанными на операция со строками полями по умолчанию. Перечисление 5 показывает пример, ищущий поля записи для строк маркера bob и smith. Каждое отличное слово обрабатывается как отдельный маркер в целях поиска. Сравнения являются случаем - и нечувствительный к диакритическому знаку. Эти строки маркера могут быть найдены в единственном поле или в многократных полях, но все маркеры должны присутствовать в записи для него, чтобы считаться соответствием.

Чтобы протестировать, являются ли два расположения друг около друга, создайте предикат с помощью distanceToLocation:fromLocation: функционируйте как показано в Перечислении 6. Предикатам, использующим эту функцию, нужно было показать структуру в перечислении. В Вашем коде замените location переменная с именем поля от одной из Ваших записей. (Этот тип данных для поля должен быть a CLLocation объект.) Точно так же заменяют fixedLoc и radius значения с надлежащими значениями из Вашего приложения. fixedLoc значение является географической координатой, отмечающей центр круга с указанным радиусом. Если расположение в записи в 10 километрах указанной широты и долготы, в этом примере предикат возвращает соответствие.

Для получения всех записей данного типа используйте TRUEPREDICATE выражение как показано в Перечислении 7. Предикат с этим оператором всегда оценивает к истине и таким образом соответствует каждую запись. При использовании такого оператора рекомендуется использовать курсор для пакетной обработки результатов в меньшие группы для обработки.