Up
Authors
- Generated by richard
-
- Declared in:
- Foundation/NSSerialization.h
Availability: OpenStep
This class is deprecated in favor of
NSPropertyListSerialization
. It provides a means of recovering a property list (NSArray or NSDictionary plus limited contents) from a byte-array (actually string) representation.
Method summary
+ (id)
deserializePropertyListFromData: (
NSData*)data
atCursor: (unsigned int*)cursor
mutableContainers: (BOOL)flag;
Availability: OpenStep
Recover a property list (NSArray or NSDictionary
plus limited contents) from a byte array.
Deprecated in favor of
[NSPropertyListSerialization
+propertyListFromData:mutabilityOption:format:errorDescription:].
+ (id)
deserializePropertyListFromData: (
NSData*)data
mutableContainers: (BOOL)flag;
Availability: OpenStep
Recover a property list (NSArray or NSDictionary
plus limited contents) from a byte array.
Deprecated in favor of
[NSPropertyListSerialization
+propertyListFromData:mutabilityOption:format:errorDescription:].
+ (id)
deserializePropertyListLazilyFromData: (
NSData*)data
atCursor: (unsigned*)cursor
length: (unsigned)length
mutableContainers: (BOOL)flag;
Availability: OpenStep
Recover a property list (NSArray or NSDictionary
plus limited contents) from a byte array. 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.
Deprecated in favor of
[NSPropertyListSerialization
+propertyListFromData:mutabilityOption:format:errorDescription:].
- Declared in:
- Foundation/NSSerialization.h
Availability: OpenStep
This class is deprecated in favor of
NSPropertyListSerialization
.
It provides a means of producing a byte-array
(actually string) representation of a property
list (NSArray or NSDictionary plus limited
contents).
Method summary
+ (
NSData*)
serializePropertyList: (id)propertyList;
Availability: OpenStep
+ (void)
serializePropertyList: (id)propertyList
intoData: (
NSMutableData*)d;
Availability: OpenStep
- Declared in:
- Foundation/NSSerialization.h
Availability: Not in OpenStep/MacOS-X
GNUstep extends deserialization by having the
option to make the resulting data more compact by
ensuring that repeated strings are only stored
once. If the property-list has a lot of repeated
strings in it, this will be more space efficient
but it will be slower (though other parts of your code
may speed up through more efficient equality testing of
uniqued strings). The default is NOT to deserialize
uniqued strings.
The
[+uniquing:]
method turns uniquing on/off. Uniquing is done using
a global
NSCountedSet
- see its documentation for details.
Method summary
+ (void)
uniquing: (BOOL)flag;
Availability: Not in OpenStep/MacOS-X
Turns uniquing (collapsing of multiple instances of a
single string in the output to one full copy plus
references) on/off.
- Declared in:
- Foundation/NSSerialization.h
Availability: Base
Likely to be changed/moved/removed at 1.17.0
GNUstep extends serialization by having the option to
make the resulting data more compact by ensuring that
repeated strings are only stored once. If the
property-list has a lot of repeated strings in
it, this will be both faster and more space efficient but
it will be slower if the property-list has few repeated
strings. The default is NOT to generate compact
versions of the data. The
[+shouldBeCompact:]
method sets default behavior. The
[+serializePropertyList:intoData:compact:]
method lets you override the default behavior.
Method summary
+ (void)
serializePropertyList: (id)propertyList
intoData: (
NSMutableData*)d
compact: (BOOL)flag;
Availability: Base
Likely to be changed/moved/removed at 1.17.0
+ (void)
shouldBeCompact: (BOOL)flag;
Availability: Base
Likely to be changed/moved/removed at 1.17.0
Specify whether to produce compacted format, with
repeated strings only written once.
- Declared in:
- Foundation/NSSerialization.h
Availability: OpenStep
Objects that are not standard property list
constituents can adopt this protocol to allow
themselves to be serialized by an
NSSerializer
and deserialized by an
NSDeserializer
.
Note, this mechanism has been deprecated and you
should instead use
NSArchiver
and related facilities to serialize objects that
are not ordinary property lists.
Method summary
- (void)
deserializeObjectAt: (id*)object
ofObjCType: (const char*)type
fromData: (
NSData*)data
atCursor: (unsigned*)cursor;
Availability: OpenStep
Decodes an object of given
type from data at position
cursor.
- (void)
serializeObjectAt: (id*)object
ofObjCType: (const char*)type
intoData: (
NSMutableData*)data;
Availability: OpenStep
Encode the given object of given
type into data, using a string
not a binary representation.
Up