NSArray+Collection

Never write another loop again

This library is inspired by Laravel collection class to use its expressive syntax. Check the .h file to see the documentation as well as all available methods.

Installation

Copy the category files to your project or just

pod 'Collection' 

Array available methods

each:block eachWithIndex:blockWithIndex map:block flatMap:block flatMap:key:block

filter:blockChecker filterWith:keyPath reject:blockChecker rejectWith:keyPath first:blockChecker first:blockChecker:default first:blockChecker:defaultBlock last:blockChecker last:blockChecker:default contains:blockChecker doesntContain:blockChecker where:keyPath:like where:keyPath:is where:keyPath:isNot whereAny:keyPaths:like whereAny:keyPaths:is whereNull whereNull:keyPath whereNotNull whereNotNull:keyPath whereIn:keyPath:values

sort sort:key sort:key:ascending sortWith:block:ascending

reverse random:quantity slice:howMany take:howMany splice:howMany pop

pluck:keyPath pluck:keyPath:keyKeyPath flatten flatten:keyPath partition:block reduce:block reduce:block:initialCarry pipe:block when:condition:block groupBy:keyPath gorupBy:keyPath:block expand:keypath

maxObject maxObject:keyPath maxObjectFor:block minObject minObject:keyPath minObjectFor:block

suffled permutations zip:other mapToAssoc:block countedSet implode:glue toString toJson

intersect:other union:other join:other diff:other minus:other minusExactOcurrences:other distinct distinct:keypath

range:to range:from:to

times:times:value times:times:callback

crossJoin:list cartesianProduct:arrays

sum sum:keyPath sumWith:block avg avg:keyPath max max:keyPath min min:keyPath countKeyPath:

map_:selector map_:selector:withObject each_:selector each_:selector:withObject filter_:selector filter_:selector:withObject reject_:selector reject_:selector:withObject

Dictionary available methods

fromData:data fromString:string toString except:keys only:keys

each:block filter:block filter:block map:block

String available methods

repeat:text:times isEmptyString explode:delimiter initials toNumber append:other prepend:other substr:from substr:from:length replace:text:with replaceRegexp:regexp:with split split:lenght trim trimWithNewLine trimLeft trimRight camelCase pascalCase snakeCase ucFirst withoutDiacritic urlEncode urlDecode md5 toBase64 fromHex:str toHex

endsWith:text startsWith:text contains:text matches:regexp

lpad:length:text rpad:length:text

Array Examples

Just some examples, check the .h or the tests to see them all In the .h there is the explanation of what it really does

NSArray* array = @[@1,@3,@4,@5,@6];
NSNumber* first = [array first:^BOOL(NSNumber* object) {
    return object.intValue > 4;
}];
NSLog(@"Fist: %@",first);

NSNumber* second = [array first:^BOOL(NSNumber* object) {
    return object.intValue > 10;
} default:@25];
NSLog(@"second: %@",second);

NSArray* oldHeroes = [self.heroes reject:^BOOL(Hero *object) {
    return object.age.intValue < 20;
}];
[self printHeroArray:oldHeroes];

[self printHeroArray:[self.heroes map:^id(Hero* obj, NSUInteger idx) {
    obj.age = @(obj.age.intValue * 2);
    return obj;
}]];
[self printArray:[self.heroes pluck:@"enemy"]];

NSNumber* totalAge = [self.heroes reduce:^id(NSNumber* carry, Hero* object) {
    return @(object.age.intValue + carry.intValue);
} carry:@(0)];

// or

NSNumber* totalAge2 = [self.heroes sum:@"age"];

NSNumber* age = [self.heroes sum:@"age"];
NSLog(@"Age again: %@",age);

NSNumber* older = [self.heroes max:@"age"];
NSLog(@"older: %@",older);

NSNumber* younger = [self.heroes min:@"age"];
NSLog(@"younger: %@",younger);

NSNumber* average = [self.heroes avg:@"age"];
NSLog(@"average: %@",average);

[self printArray:[@[@1,@2,@3,@4] union:@[@4,@5,@6]]];
[self printArray:[@[@1,@2,@3,@4] intersect:@[@4,@5,@6]]];
[self printArray:[@[@1,@2,@3,@4] join:@[@4,@5,@6]]];
[self printArray:[@[@1,@2,@3,@4] diff:@[@4,@5,@6]]];

[self.heroes groupBy:@"age"];

[self.heroes groupBy:@"age" block:^NSString *(Hero *object, NSString *key) {
    return str(@"age %@", object.age);
}];

NSArray* names = @["Spiderman", @"Batman", @"Robin", @"Luxor"];
BOOL containsSpiderman = [self.names contains:^BOOL(Hero* hero) {
    return [hero.name isEqualToString:@"Spiderman"];
}];

BOOL heroes = [self.names where:@"name" like:@"man"];
// heroes => [@"Spiderman, @"Batman"] 

[@[@1,@2,@3,@4,@5,@6] slice:3];
[@[@1,@2,@3,@4,@5,@6] slice:10];
[@[@1,@2,@3,@4,@5,@6] slice:6];
[@[@1,@2,@3,@4,@5,@6] take:2];
[@[@1,@2,@3,@4,@5,@6] take:10];
[@[@1,@2,@3,@4,@5,@6] take:-2];
[@[@1,@2,@3,@4,@5,@6] take:-10];

NSArray* array2 = @[@1,@2,@3,@4,@5].mutableCopy;
NSArray* chunk = [array2 splice:2];
[self printArray:chunk];
[self printArray:array2];

Dictionary Examples

Just some examples, check the .h or the tests to see them all

NSDictionary* filtered = [@{@"pass":@0, @"dontPass":@1} filter:^BOOL(id key, id object) {
    return object.floatValue == 0;
}];

NSDictionary* result = [@{@"toBeMapped":@"value", @"toBeMapped2":@"value2"} map:^id(id key, id object) {
    return [key append:object];
}];

String Examples

Just some examples, check the .h or the tests to see them all

// [NSString stringWithFormat:@"a formated %@ string", value]; 
// becomes
str(@"a formated %@ string", value);

NSArray* result         = [@"hola;que;tal" explode:@";"];
NSArray* expectation    = @[@"hola",@"que",@"tal"];
XCTAssertTrue([result isEqual:expectation]);

NSString* result = [@"   trim   " trim];
XCTAssertTrue( [result isEqualToString:@"trim"]);

NSString* result = @"this should be camelcased".camelCase;
XCTAssertTrue( [result isEqualToString:@"thisShouldBeCamelcased"]);