Deprecated NSData Methods

A method identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in iOS 4.0

getBytes:

Copies a data object’s contents into a given buffer. (Deprecated in iOS 4.0. This method is unsafe because it could potentially cause buffer overruns. You should use getBytes:length: or getBytes:range: instead.)

- (void)getBytes:(void *)buffer
Parameters
buffer

A buffer into which to copy the receiver's data. The buffer must be at least length bytes.

Discussion

You can see a sample using this method in “Working With Binary Data”.

Availability
  • Available in iOS 2.0 and later.
  • Deprecated in iOS 4.0.
See Also
Declared In
NSData.h

Deprecated in iOS 5.0

dataWithContentsOfMappedFile:

Creates and returns a data object from the mapped file specified by path. (Deprecated in iOS 5.0.)

+ (id)dataWithContentsOfMappedFile:(NSString *)path
Parameters
path

The absolute path of the file from which to read data.

Return Value

A data object from the mapped file specified by path. Returns nil if the data object could not be created.

Discussion

Because of file mapping restrictions, this method should only be used if the file is guaranteed to exist for the duration of the data object’s existence. It is generally safer to use the dataWithContentsOfFile: method.

This methods assumes mapped files are available from the underlying operating system. A mapped file uses virtual memory techniques to avoid copying pages of the file into memory until they are actually needed.

Availability
  • Available in iOS 2.0 and later.
  • Deprecated in iOS 5.0.
See Also
Related Sample Code
Declared In
NSData.h

initWithContentsOfMappedFile:

Returns a data object initialized by reading into it the mapped file specified by a given path. (Deprecated in iOS 5.0.)

- (id)initWithContentsOfMappedFile:(NSString *)path
Parameters
path

The absolute path of the file from which to read data.

Return Value

A data object initialized by reading into it the mapped file specified by path. The returned object might be different than the original receiver.

Availability
  • Available in iOS 2.0 and later.
  • Deprecated in iOS 5.0.
See Also
Declared In
NSData.h


© 2012 Apple Inc. All Rights Reserved. (Last updated: 2012-07-17)

Did this document help you? Yes It's good, but... Not helpful...