NitroNSArrayCategories 1.0.1

You want to add pod 'NitroNSArrayCategories', '~> 1.0' similar to the following to your Podfile:

target 'MyApp' do
  pod 'NitroNSArrayCategories', '~> 1.0'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try NitroNSArrayCategories

NitroNSArrayCategories 1.0.1

By
Daniel L. Alves
alveslopesdan

NitroNSArrayCategories offers some NSArray missing features and utilities. You will find:

Transform methods
Safe indexing methods
Filtering methods

Examples

1) Transform methods

Apply an operation on every array object returning the results in a new array.

NSArray *incredibles = @[ @"Mr. Incredible", @"Elastigirl", @"Violet", @"Violet", @"Jack-Jack" ];

// With selectors that receive no arguments:
// uppercasedIncredibles will be @[ @"MR. INCREDIBLE", @"ELASTIGIRL", @"VIOLET", @"DASH", @"JACK-JACK"];
NSArray *uppercasedIncredibles = [incredibles transformWithSelector: @selector(uppercaseString)];

// ...

NSArray *animals = @[ @{ @"kind" : @"cat", @"id": @( 1 ) },
                      @{ @"kind" : @"dog", @"id": @( 2 ) },
                      @{ @"kind" : @"pig", @"id": @( 3 ) } ];

// With selectors that receive one argument:
// animalKinds will be @[ @"cat", @"dog", @"pig" ]
NSArray *animalKinds = [animals transformWithSelector: @selector(objectForKeyedSubscript:) 
                                            andObject: @"kind"];

// With blocks:
// animalsIds will be @[ @1, @2, @3 ]
NSArray *animalIds = [animals transformWithBlock: ^NSObject * ( NSObject *obj ){
    return (( NSDictionary * )obj)[ @"id"];
}];

2) Safe indexing methods

Return nil (or NSNull) if an index is out of bounds:

NSArray *array = @[ @1, @2, @3 ];

[array nilOrObjectAtIndex: 2]; // Returns @3
[array nilOrObjectAtIndex: 3]; // Returns nil
[array nsnullOrObjectAtIndex: 90]; // Returns [NSNull null]

3) Filtering methods

Tired of calling indexesOfObjectsPassingTest: and then objectsAtIndexes:? There you go:

NSArray *array = @[ @0, @1, @2, @3, @4, @5, @6, @7, @8, @9 ];

// oddNumbers will be @[ @1, @3, @5, @7, @9 ];
NSArray *oddNumbers = [array objectsPassingTest: ^BOOL( id obj, NSUInteger idx, BOOL *stop ){
    return ([( NSNumber * )obj intValue] & 1 ) != 0;
}];

Requirements

iOS 4.3 or higher, ARC only

Installation

NitroNSArrayCategories is available through CocoaPods, to install it simply add the following line to your Podfile:

pod "NitroNSArrayCategories"

NitroNSArrayCategories adds the -ObjC linker flag to targets using it. Without it, categories code would be stripped out, resulting in linker errors. For more info about categories inside static libraries, see: Building Objective-C static libraries with categories

Author

Daniel L. Alves (@alveslopesdan)

License

NitroNSArrayCategories is available under the MIT license. See the LICENSE file for more info.