NSMutableCopying Protocol Reference
Various Cocoa classes
Available in iOS 2.0 and later.
NSMutableCopying protocol declares a method for providing mutable copies of an object. Only classes that define an “immutable vs. mutable” distinction should adopt this protocol. Classes that don’t define such a distinction should adopt
NSMutableCopying declares one method,
mutableCopyWithZone:, but mutable copying is commonly invoked with the convenience method
mutableCopy method is defined for all NSObjects and simply invokes
mutableCopyWithZone: with the default zone.
If a subclass inherits NSMutableCopying from its superclass and declares additional instance variables, the subclass has to override
mutableCopyWithZone: to properly handle its own instance variables, invoking the superclass’s implementation first.
– mutableCopyWithZone:required method
Returns a new instance that’s a mutable copy of the receiver. (required)
The zone from which memory is allocated for the new instance. If zone is
NULL, the new instance is allocated from the default zone, which is returned by
The returned object is implicitly retained by the sender, which is responsible for releasing it. The copy returned is mutable whether the original is mutable or not.
- Available in iOS 2.0 and later.
© 2006 Apple Computer, Inc. All Rights Reserved. (Last updated: 2006-05-23)