//
//  NSMutableDictionary+BlocksKit.h
//  %PROJECT
//

#import "BKGlobals.h"

/** Block extensions for NSMutableDictionary.
 
 These utilities expound upon the BlocksKit additions
 to the immutable superclass by allowing certain utilities
 to work on an instance of the mutable class, saving memory
 by not creating an immutable copy of the results.
 
 Includes code by the following:
 
 - Martin Sch?rrer.  <https://github.com/MSch>.	 2011. MIT.
 - Zach Waldowski. <https://github.com/zwaldowski>. 2011. MIT.
 
 @see NSDictionary(BlocksKit)
 */
@interface NSMutableDictionary (BlocksKit)

/** Filters a mutable dictionary to the key/value pairs matching the block.
 
 @param block A BOOL-returning code block for a key/value pair.
 @see reject:
 */
- (void)performSelect:(BKKeyValueValidationBlock)block;

/** Filters a mutable dictionary to the key/value pairs not matching the block,
 the logical inverse to select:.
 
 @param block A BOOL-returning code block for a key/value pair.
 @see select:
 */
- (void)performReject:(BKKeyValueValidationBlock)block;

/** Transform each value of the dictionary to a new value, as returned by the
 block.
 
 @param block A block that returns a new value for a given key/value pair.
 */
- (void)performMap:(BKKeyValueTransformBlock)block;

@end