NSArray - Revision history

Newacct: /* From a List */

2009-05-12T08:00:49Z

From a List

Newacct at 04:21, 12 May 2009

2009-05-12T04:21:35Z

Geroldr at 19:08, 22 October 2007

2007-10-22T19:08:33Z

Kendall: /* Creating Arrays / added / See Also */ added

2007-04-05T00:13:41Z

Creating Arrays: added See Also: added

Cbv: NSArray of course is in Foundation, not AppKit...

2006-04-21T15:54:33Z

NSArray of course is in Foundation, not AppKit...

Cbv: Added categories

2006-04-21T15:49:17Z

Added categories

Stefan Urbanek: added a reference to the KVC

2005-02-17T09:17:57Z

added a reference to the KVC

Stefan Urbanek at 21:24, 16 February 2005

2005-02-16T21:24:49Z

New page

Well ... array.

== Code chunks ==

=== Create index dictionary ===

Following method creates a dictionary which works as index by an attribute of contained objects.

- (NSDictionary *)indexDictionaryForKey:(NSString *)key
{
NSMutableDictionary *dict = [[NSMutableDictionary alloc] init];
NSDictionary *retval;
NSEnumerator *enumerator;
id object;

enumerator = [self objectEnumerator];

while( (object = [enumerator nextObject]) )
{
[dict setObject:object forKey:[object valueForKey:key]];
}

retval = [[NSDictionary alloc] initWithDictionary:dict];
RELEASE(dict);

return AUTORELEASE(retval);
}

@@ Line 9: / Line 9: @@
    NSArray *array = [NSArray arrayWithObjects: @"John", @"Bob", [NSNull null], @"Jane", nil];
-When creating arrays remember that any kind of object can be included, but only objects can be included. Note that <code>nil</code> values cannot be included in an array; you should use the <code>[[[NSNull]] null]</code> dummy object instead.
+When creating arrays remember that any kind of object can be included, but only objects can be included. Note that <code>nil</code> values cannot be included in an array; you should use the [[NSNull|<code>[NSNull null]</code>]] dummy object instead.
 Note that when you provide a variable-length list of objects in Objective-C, you need to "terminate" the list with <code>nil</code>. Otherwise, the function has no way of knowing how many arguments there are.

@@ Line 7: / Line 7: @@
 The most common method to create an array is to just pass it a list:
-   NSArray *array = [NSArray arrayWithObjects: @"John", @"Bob", [NSNull null], @"Jane"];
+   NSArray *array = [NSArray arrayWithObjects: @"John", @"Bob", [NSNull null], @"Jane", nil];
-When creating arrays remember that any kind of object can be included, but only objects can be included.
+When creating arrays remember that any kind of object can be included, but only objects can be included. Note that <code>nil</code> values cannot be included in an array; you should use the <code>[[[NSNull]] null]</code> dummy object instead.
 === Copy an Array ===
@@ Line 15: / Line 17: @@
 A copy of an array can be done simply by doing the following:
-   NSArray *array1 = [NSArray arrayWithObjects: @"John", @"Bob", [NSNull null], @"Jane"];
+   NSArray *array1 = [NSArray arrayWithObjects: @"John", @"Bob", [NSNull null], @"Jane", nil];
    NSArray *array2 = [NSArray arrayWithArray: array1];

@@ Line 1: / Line 1: @@
-[http://www.gnustep.org/resources/documentation/Developer/Base/Reference/NSArray.html#class$NSArray NSArray] is a immutable, integer indexed, array of objects.
+[http://www.gnustep.org/resources/documentation/Developer/Base/Reference/NSArray.html#class$NSArray NSArray] is an immutable, integer indexed, array of objects.
 == Creating Arrays ==
@@ Line 5: / Line 5: @@
 === From a List ===
-The most common method to create a array is to just pass it a list:
+The most common method to create an array is to just pass it a list:
    NSArray *array = [NSArray arrayWithObjects: @"John", @"Bob", [NSNull null], @"Jane"];
@@ Line 11: / Line 11: @@
 When creating arrays remember that any kind of object can be included, but only objects can be included.
-=== Copy Array ===
+=== Copy an Array ===
 A copy of an array can be done simply by doing the following:
@@ Line 18: / Line 18: @@
    NSArray *array2 = [NSArray arrayWithArray: array1];
-=== From a Array ===
+=== From an Array ===
 An array object can be made with a regular array of objects, as shown in the following example:

@@ Line 1: / Line 1: @@
-Well ... array.
+[http://www.gnustep.org/resources/documentation/Developer/Base/Reference/NSArray.html#class$NSArray NSArray] is a immutable, integer indexed, array of objects.
 == Code chunks ==
@@ Line 26: / Line 52: @@
      return AUTORELEASE(retval);
+  }
 [[Category:Foundation]]
 [[Category:Snippets]]

← Older revision		Revision as of 15:54, 21 April 2006
Line 28:		Line 28:


−	[[Category:~~AppKit~~]]	+	[[Category:Foundation]]
	[[Category:Snippets]]		[[Category:Snippets]]

← Older revision		Revision as of 15:49, 21 April 2006
Line 26:		Line 26:
	return AUTORELEASE(retval);		return AUTORELEASE(retval);
	}		}
		+
		+
		+	[[Category:AppKit]]
		+	[[Category:Snippets]]

@@ Line 5: / Line 5: @@
 === Create index dictionary ===
-Following method creates a dictionary which works as index by an attribute of contained objects.
+Following NSArray category method creates a dictionary which works as an index by an attribute of contained objects. It uses [[Key Value Coding]].
   - (NSDictionary *)indexDictionaryForKey:(NSString *)key