class NSPredicate : NSObject, NSCopying, NSSecureCoding

<aside> 💡 Predicate은 객체들을 필터링할때 사용하는 논리적 조건, 즉 질의(query)를 나타낸다. NSComparisonPredicate, NSCompoundPredicate, NSExpression 객체 등에서 predicate을 직접 생성할 수도 있지만, NSPredicate의 타입 메소드에 predicate 문자열 양식을 전달하여 predicate을 생성하는 것이 일반적이다.

<aside> ✋ NSComparisonPredicate, NSCompoundPredicate, NSExpression 페이지는 왜 없나요?

• 1. NSPredicate 사용법만 잘 정리한다면 나머지 API들은 공식 문서를 통해서도 이해 및 사용할 수 있겠다고 판단했기 때문이다.
• 2. NSPredicate 타입이 새 Predicate 타입으로 대체될 예정이기 때문이다. </aside>

<aside> 📢 본인 프로젝트의 minimum deployment가 iOS 17 및 기타 이상이라면, Predicate 타입을 사용하기를 권장한다. NSPredicate에서도 Predicate을 인자로 받는 생성자가 추가되었으므로, 기존 NSPredicate이 사용되던 모든 곳에서 Predicate을 사용할 수 있다. 새 Predicate 타입은 새 매크로 시스템을 사용하여 Swift 구문으로 조건식을 작성할 수 있으며 의미 분석, 타입 추론, syntax highlighting 등을 지원하므로 모든 면에서 우월하다.

단, Predicate을 NSPredicate으로 변환하기 위해서는 몇가지 주의사항이 있다. 해당 생성자 설명을 참고하자: 2023년 - Predicate을 인수로 받는 생성자 추가.

</aside>

NSPredicate 문자열 양식 문법

<aside> <img src="/icons/list_blue.svg" alt="/icons/list_blue.svg" width="40px" /> 목차

</aside>

</aside>

개요

predicate은 주어진 객체에 대해 조건으로부터 논리값(Boolean)을 반환하는 구문 단위로서, 표현식(expression)과 연산자(operator)의 조합으로 이루어진다. 주로 다음 부류에서 활용된다:

• Spotlight
• Core Data
• in-memory 객체 필터링(NSArray, NSSet, NSOrderedSet, NSMutable〃)

<aside> ✋ 위 경우가 아니면 사용할 수 없나요?

• 그렇지는 않다. Collection 프로토콜의 filter 함수 등에서 사용될 수도 있다. </aside>

NSPredicate 클래스는 문자열 양식을 통한 predicate 생성 메소드와 predicate 평가 메소드를 제공한다. 두 서브클래스를 가진다:

• NSComparisonPredicate: 가운데 놓인 연산자를 사용하여 양측에 놓인 표현식을 서로 비교한다. 각 표현식은 predicate으로 추론되어 평가되며, 평가된 값에 대해 연산자를 호출한 결과를 반환한다.
• NSCompoundPredicate: 두개 이상의 predicate들을 평가한 결과를 비교한다. 또는 특정 predicate 결과를 무시한다.

또한, predicate의 표현식은 모두 NSExpression 객체로 나타낸다. 가장 간단한 표현식은 상수다. 예를 들어, predicate 내에서 평가되는 중인 객체의 keypath로부터 값을 얻어오는 경우가 빈번할 것이다. 그 외에도 predicate 내에서 평가되는 중인 객체를 나타낼 때, predicate 내에서 변수로 채워져야 하는 부분의 placeholder를 나타낼 때, 배열 내에서 연산을 수행한 결과를 반환할 때 모두 NSExpression으로 표현된다.

한계점

predicate을 통한 query에는 실제 구현된 공통 언어가 존재하지 않으므로, 상응하는 데이터 Store에 맞추어 SQL, XML, 또는 기타 다양한 형식으로 번역된다. Cocoa의 predicate 시스템은 유용한 범위의 연산자들을 제공하는 것에 목적을 두므로, 모든 데이터 Store에서 predicate이 제공하는 query 명령어를 100% 지원하는 것이 아니며, predicate 시스템에서 모든 데이터 Store가 제공하는 전체 질의 방법을 100% 지원하는 것도 아니다. 따라서 경우에 따라 predicate의 일부 디테일들은 무시될 수 있으며(문자열 비교 predicate이 기존 의도와 달리 대소문자를 구별하지 않는다거나), 지원되지 않는 연산자를 사용할 경우 에러를 던질 수도 있다. 예를 들어:

• MATCHES 연산자는 regex를 사용하므로, Core Data의 SQL Store에서는 지원되지 않는다. (물론, in-memory 필터링에서는 가능하다)
• Core Data의 SQL Store는 각 query당 단일 to-many 연산자만을 지원한다. 따라서 SQL Store에 predicate을 전달할 때 ALL, ANY, IN 등의 연산자가 여러개 있는 경우 하나의 연산자만 전달되어 오류가 발생할 수 있다.
• 대부분의 SQL query 명령어는 predicate에서 식별할 수 없다.
• ANYKEY 연산자는 Spotlight에서만 사용 가능하다.