# filter(_:) Returns a new dictionary containing the key-value pairs of the dictionary that satisfy the given predicate. ``` consuming func filter(_ isIncluded: (Dictionary.Element) throws(E) -> Bool) throws(E) -> [Key : Value] where E : Error ``` ## Parameters `isIncluded` A closure that takes a key-value pair as its argument and returns a Boolean value indicating whether the pair should be included in the returned dictionary. ## Return Value A dictionary of the key-value pairs that `isIncluded` allows. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)