NSArray+ObjectiveSugar.h

//
//  NSArray+ObjectiveSugar.h
//  Objective Sugar
//
//  Created by Marin Usalj on 5/7/12.
//  Copyright (c) 2012 __MyCompanyName__. All rights reserved.
//

// For an overview see http://cocoadocs.org/docsets/ObjectiveSugar/

@interface NSArray (ObjectiveSugar)

- (id)first DEPRECATED_MSG_ATTRIBUTE("Please use -firstObject instead");

- (id)last DEPRECATED_MSG_ATTRIBUTE("Please use -lastObject instead");

- (id)sample;

- (id)anyObject;


- (id)objectForKeyedSubscript:(id <NSCopying>)key;


- (void)each:(void (^)(id object))block;

- (void)eachWithIndex:(void (^)(id object, NSUInteger index))block;

- (void)each:(void (^)(id object))block options:(NSEnumerationOptions)options;

- (void)eachWithIndex:(void (^)(id object, NSUInteger index))block options:(NSEnumerationOptions)options;


- (BOOL)includes:(id)object;

- (NSArray *)take:(NSUInteger)numberOfElements;

- (NSArray *)takeWhile:(BOOL (^)(id object))block;

- (NSArray *)map:(id (^)(id object))block;

- (NSArray *)select:(BOOL (^)(id object))block;

- (id)detect:(BOOL (^)(id object))block;


- (id)find:(BOOL (^)(id object))block;

- (NSArray *)reject:(BOOL (^)(id object))block;

- (NSArray *)flatten;

- (NSArray *)compact;

- (NSString *)join;

- (NSString *)join:(NSString *)separator;

- (NSArray *)sort;

- (NSArray *)sortBy:(NSString *)key;

- (NSArray *)reverse;

- (NSArray *)intersectionWithArray:(NSArray *)array;

- (NSArray *)unionWithArray:(NSArray *)array;

- (NSArray *)relativeComplement:(NSArray *)array;

- (NSArray *)symmetricDifference:(NSArray *)array;

- (id)reduce:(id (^)(id accumulator, id object))block;

- (id)reduce:(id)initial withBlock:(id (^)(id accumulator, id object))block;

- (NSArray *)unique;

@end