EOOrQualifier

Inherits From:
EOQualifier : NSObject

Conforms To: EOQualifierEvaluation
EOQualifierSQLGeneration

Declared in: EOControl/EOQualifier.h

EOOrQualifier is a subclass of EOQualifier that contains multiple qualifiers. EOOrQualifier adopts the EOQualifierEvaluation protocol, which defines the method evaluateWithObject: for in-memory evaluation. When an EOOrQualifier object receives an evaluateWithObject: message, it evaluates each of its qualifiers until one of them returns YES. If one of its qualifiers returns YES, the EOOrQualifier object returns YES immediately. If all of its qualifiers return NO, the EOOrQualifier object returns NO.

Adopted Protocols

EOQualifierEvaluation

- evaluateWithObject:

EOQualifierSQLGeneration

- sqlStringForSQLExpression:

- schemaBasedQualifierWithRootEntity:

evaluateWithObject:

- (BOOL)evaluateWithObject:(id)anObject

Returns YES if anObject satisfies the qualifier, NO otherwise. When an EOOrQualifier object receives an evaluateWithObject: message, it evaluates each of its qualifiers until one of them returns YES. If any of its qualifiers returns YES, the EOOrQualifier object returns YES immediately. If all of its qualifiers return NO, the EOOrQualifier object returns NO. This method can raise one of several possible exceptions if an error occurs. If your application allows users to construct arbitrary qualifiers (such as through a user interface), you may want to write code to catch any exceptions and respond to errors (for example, by displaying a panel saying that the user typed a poorly formed qualifier).

initWithQualifierArray:

Initializes the receiver with the qualifiers qualifiers and returns self. This method is the designated initializer for EOOrQualifier.

initWithQualifiers:

Initializes the receiver with the nil-terminated list of qualifiers qualifiers. Works by invoking initWithQualifierArray:. For example, the following code excerpt constructs three qualifiers, qual1, qual2, and qual3. It then uses these qualifiers to initialize an EOOrQualifier, orQual. orQual is then used to filter an in-memory array.

NSArray *guests;    /* Assume this exists. */

EOQualifier *qual1, *qual2, *qual3, *orQual;
			

qual1 = [EOQualifier qualifierWithQualifierFormat:@"lastName = 'Nunez'"];

qual2 = [EOQualifier qualifierWithQualifierFormat:@"lastName = 'Wren'"];

qual3 = [EOQualifier qualifierWithQualifierFormat:@"lastName = 'Wilson'"];
			

/* Initialize the EOOrQualifier orQual using a nil-terminated list of

 * qualifiers.

 */

orQual = [[EOOrQualifier alloc] initWithQualifiers:qual1, qual2, qual3, nil];

/* Use orQual to filter the array guests. */

return [guests filteredArrayUsingQualifier:orQual];

qualifiers

Returns the receiver's qualifiers.