---
title: "evaluate(with:substitutionVariables:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/nspredicate/evaluate(with:substitutionvariables:)"
---

# evaluate(with:substitutionVariables:)

Returns a Boolean value that indicates whether the specified object matches the conditions that the predicate specifies after substituting in the values from a specified variables dictionary.

## Declaration

```swift
func evaluate(with object: Any?, substitutionVariables bindings: [String : Any]?) -> Bool
```

## Parameters

- `object`: The object against which to evaluate the predicate.
- `bindings`: The substitution variables dictionary. The dictionary must contain key-value pairs for all variables in the predicate.

## Return Value

Return Value true if object matches the conditions specified by the predicate after substituting in the values in bindings for any replacement tokens, otherwise false.

## Discussion

Discussion This method returns the same result as the two step process of first invoking withSubstitutionVariables(_:) on the predicate and then invoking evaluate(with:) on the returned value. This method is optimized for situations which require repeatedly evaluating a predicate with substitution variables with different variable substitutions.

## See Also

### Evaluating a Predicate

- [evaluate(with:)](foundation/nspredicate/evaluate(with:).md)
- [allowEvaluation()](foundation/nspredicate/allowevaluation().md)