NSArray

Crowd-sourced documentation and tutorials by the Cocoa developer community
Jump to: navigation, search

Documentation at the AppleDeveloperConnection:

http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSArray_Class/index.html#//apple_ref/doc/uid/TP40003620

See FoundationCollections for an overview; see DesignArray for a critique of the array design in general



NSArray implements -(BOOL)doesContain:(id)anObject which returns true if the array contains anObject, by identity.


Note that the same behavior can be gotten through documented methods with the following code: - (BOOL)containsObjectIdenticalTo:(id)anObject { return NSNotFound != [self indexOfObjectIdenticalTo:anObject]; }

And in fact I imagine this is how -doesContain: is implemented.


Another excellent method that NSArray provides is -(void) makeObjectsPerformSelector:(SEL)aSel [myArray makeObjectsPerformSelector:@selector(stroke)];


Yeah, but if they were thinking clearly, they would have returned a new array containing the results of each method call.


Like this? - (NSArray )makeObjectsPerformSelectorAndReturnResults:(SEL)selector { NSMutableArray results = [[[NSMutableArray]] array]; NSEnumerator e = [self objectEnumerator]; id obj; while (obj = [e nextObject]) { if ([obj respondsToSelector:selector]) [results addObject:[obj performSelector:selector]]; } return results; }


Yeah, thanks! I didn't expect code...this could be useful.


There are several methods of this sort in cocoadev's NSArrayCategory.


I don't know if the code above should be considered reliable; there are lots of selectors where the methods don't return objects. Although I don't think there's any two method signatures with differing return types, there could be in the future. I've been working on a catch-all for this in another context. It's not done yet, but when it is I'll see about posting it.


Note that Cocoa already provides a similar method, via valueForKey:. These two lines are basically equivalent:

newArray = [array makeObjectsPerformSelectorAndReturnResults: @selector( someMethod )]; newArray = [array valueForKey: @"someMethod"];

As a bonus, the built-in method will autobox return values from methods that return primitives and it will also grab ivars directly if you provide its name and there's no accessor method.


Check out the -mapUsingSelector: method of the NSArray+Functional category: http://seriot.ch/software_cli.php#nsarray_functional

It allows you to do the same but with variable arguments selectors.

NSArray a = [[[NSArray]] arrayWithObjects:@"a", @"ab", @"abc", @"bc", @"c", nil];

NSArray x = [a filterUsingSelector:@selector(hasPrefix:), @"a", nil]; NSArray y = [a mapUsingSelector:@selector(uppercaseString), nil]; NSArray z = [a reduceUsingSelector:@selector(stringByAppendingString:)];

Results:

x: (a, ab, abc) y: (A, AB, ABC, BC, C) z: aababcbcc


Sample Code:


Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox