Class: NSPredicate
Overview
The NSPredicate class is used to define logical conditions used to constrain a search either for a fetch or for in-memory filtering.
Direct Known Subclasses
Class Method Summary (collapse)
-
+ predicateWithBlock:
Creates and returns a predicate that evaluates using a specified block object and bindings dictionary.
-
+ predicateWithFormat:
Creates and returns a new predicate formed by creating a new string with a given format and parsing the result.
-
+ predicateWithFormat:argumentArray:
Creates and returns a new predicate by substituting the values in a given array into a format string and parsing the result.
-
+ predicateWithFormat:arguments:
Creates and returns a new predicate by substituting the values in an argument list into a format string and parsing the result.
-
+ predicateWithValue:
Creates and returns a predicate that always evaluates to a given value.
Instance Method Summary (collapse)
-
- evaluateWithObject:
Returns a Boolean value that indicates whether a given object matches the conditions specified by the receiver.
-
- evaluateWithObject:substitutionVariables:
Returns a Boolean value that indicates whether a given object matches the conditions specified by the receiver after substituting in the values in a given variables dictionary.
-
- predicateFormat
Returns the receiver’s format string.
-
- predicateWithSubstitutionVariables:
Returns a copy of the receiver with the receiver’s variables substituted by values specified in a given substitution variables dictionary.
Methods inherited from NSObject
#!, #!=, #!~, #, #==, #===, #=~, #Rational, #__callee__, #__method__, #__send__, #__type__, `, alloc, allocWithZone:, #autoContentAccessingProxy, autoload, autoload?, autorelease_pool, #awakeAfterUsingCoder:, binding, block_given?, caller, cancelPreviousPerformRequestsWithTarget:, cancelPreviousPerformRequestsWithTarget:selector:object:, catch, class, classFallbacksForKeyedArchiver, #classForCoder, #classForKeyedArchiver, classForKeyedUnarchiver, #clone, conformsToProtocol:, #copy, copyWithZone:, #dealloc, #define_singleton_method, description, display, #doesNotRecognizeSelector:, #dup, #enum_for, #eql?, #equal?, #extend, fail, #finalize, format, #forwardInvocation:, #forwardingTargetForSelector:, framework, #freeze, #frozen?, getpass, gets, global_variables, #init, initialize, #initialize_clone, #initialize_copy, #initialize_dup, #inspect, instanceMethodForSelector:, instanceMethodSignatureForSelector:, #instance_eval, #instance_exec, #instance_of?, #instance_variable_defined?, #instance_variable_get, #instance_variable_set, #instance_variables, instancesRespondToSelector:, isSubclassOfClass:, #is_a?, iterator?, #kind_of?, lambda, load, load_bridge_support_file, load_plist, local_variables, loop, #method, #methodForSelector:, #methodSignatureForSelector:, #methods, #mutableCopy, mutableCopyWithZone:, new, #nil?, open, p, #performSelector:onThread:withObject:waitUntilDone:, #performSelector:onThread:withObject:waitUntilDone:modes:, #performSelector:withObject:afterDelay:, #performSelector:withObject:afterDelay:inModes:, #performSelectorInBackground:withObject:, #performSelectorOnMainThread:withObject:waitUntilDone:, #performSelectorOnMainThread:withObject:waitUntilDone:modes:, print, printf, #private_methods, proc, #protected_methods, #public_method, #public_methods, #public_send, putc, puts, raise, rand, readline, readlines, #replacementObjectForCoder:, #replacementObjectForKeyedArchiver:, require, resolveClassMethod:, resolveInstanceMethod:, #respond_to?, #respond_to_missing?, select, #send, setVersion:, #singleton_methods, sprintf, srand, superclass, #taint, #tainted?, #tap, test, throw, #to_plist, #to_s, trace_var, trap, #trust, #untaint, untrace_var, #untrust, #untrusted?, version
Constructor Details
This class inherits a constructor from NSObject
Dynamic Method Handling
This class handles dynamic methods through the method_missing method in the class NSObject
Class Method Details
+ (NSPredicate) predicateWithBlock(block)
Creates and returns a predicate that evaluates using a specified block object and bindings dictionary.
+ (NSPredicate) predicateWithFormat(format, ...)
Creates and returns a new predicate formed by creating a new string with a given format and parsing the result. For details of the format of the format string and of limitations on variable substitution, see Predicate Format String Syntax.
+ (NSPredicate) predicateWithFormat(predicateFormat, argumentArray:arguments)
Creates and returns a new predicate by substituting the values in a given array into a format string and parsing the result. For details of the format of the format string and of limitations on variable substitution, see Predicate Format String Syntax.
+ (NSPredicate) predicateWithFormat(format, arguments:argList)
Creates and returns a new predicate by substituting the values in an argument list into a format string and parsing the result. For details of the format of the format string and of limitations on variable substitution, see Predicate Format String Syntax.
+ (NSPredicate) predicateWithValue(value)
Creates and returns a predicate that always evaluates to a given value.
Instance Method Details
- (Boolean) evaluateWithObject(object)
Returns a Boolean value that indicates whether a given object matches the conditions specified by the receiver.
- (Boolean) evaluateWithObject(object, substitutionVariables:variables)
Returns a Boolean value that indicates whether a given object matches the conditions specified by the receiver after substituting in the values in a given variables dictionary. This method returns the same result as the two step process of first invoking predicateWithSubstitutionVariables: on the receiver and then invoking evaluateWithObject: on the returned predicate. This method is optimized for situations which require repeatedly evaluating a predicate with substitution variables with different variable substitutions.
- (String) predicateFormat
Returns the receiver’s format string.
- (NSPredicate) predicateWithSubstitutionVariables(variables)
Returns a copy of the receiver with the receiver’s variables substituted by values specified in a given substitution variables dictionary. The receiver itself is not modified by this method, so you can reuse it for any number of substitutions.