PATH  Documentation > Mac OS X > Foundation Reference: Objective-C



Table of Contents

NSDeserializer


Inherits from:
NSObject
Conforms to:
NSObject
(NSObject)
Declared in:
Foundation/NSSerialization.h




Class Description


The NSDeserializer class declares methods that convert an abstract representation of a property list (as contained in an NSData object) into a graph of property list objects in memory. The NSDeserializer class object itself provides these methods-you don't create instances of NSDeserializer. Options to these methods allow you to specify that container objects (arrays or dictionaries) in the resulting graph be mutable or immutable; that deserialization begin at the start of the data or from some position within it; or that deserialization occur lazily, so a property list is deserialized only if it is actually going to be accessed. See the NSSerializer specification for more information on serialization.




Class Methods



deserializePropertyListFromData:atCursor:mutableContainers:

+ (id)deserializePropertyListFromData:(NSData *)data atCursor:(unsigned *)cursor mutableContainers:(BOOL)mutable

Returns a property list object corresponding to the abstract representation in data at the location cursor. If mutable is YES and the object is a dictionary or an array, the re-composed object is made mutable. Returns nil if the object is not a valid one for property lists.

deserializePropertyListFromData:mutableContainers:

+ (id)deserializePropertyListFromData:(NSData *)serialization mutableContainers:(BOOL)mutable

Returns a property list object corresponding to the abstract representation in serialization or nil if serialization doesn't represent a property list. If mutable is YES and the object is a dictionary or an array, the re-composed object is made mutable.

deserializePropertyListLazilyFromData:atCursor:length:mutableContainers:

+ (id)deserializePropertyListLazilyFromData:(NSData *)data atCursor:(unsigned *)cursor length:(unsigned)length mutableContainers:(BOOL)mutable

Returns a property list from data at location cursor or nil if data doesn't represent a property list. The deserialization proceeds lazily-that is, if the data at cursor has a length greater than length, a proxy is substituted for the actual property list as long as the constituent objects of that property list are not accessed. If mutable is YES and the object is a dictionary or an array, the re-composed object is made mutable.


Table of Contents