Type Method

dataWithContentsOfFile:options:error:

Creates a data object by reading every byte from the file at a given path.

Declaration

+ (instancetype)dataWithContentsOfFile:(NSString *)path options:(NSDataReadingOptions)readOptionsMask error:(NSError * _Nullable *)errorPtr;

Parameters

path

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

mask

A mask that specifies options for reading the data. Constant components are described in NSDataReadingOptions.

errorPtr

If an error occurs, upon return contains an error object that describes the problem.

Discussion

This method returns nil if the data object could not be created. In this case, errorPtr will contain an NSError indicating the problem.

See Also

Reading Data from a File

+ dataWithContentsOfFile:

Creates a data object by reading every byte from the file at a given path.

+ dataWithContentsOfURL:

Creates a data object containing the data from the location specified by a given URL.

+ dataWithContentsOfURL:options:error:

Creates a data object containing the data from the location specified by a given URL.

- initWithContentsOfFile:

Initializes a data object with the content of the file at a given path.

- initWithContentsOfFile:options:error:

Initializes a data object with the content of the file at a given path.

- initWithContentsOfURL:

Initializes a data object with the data from the location specified by a given URL.

- initWithContentsOfURL:options:error:

Initializes a data object with the data from the location specified by a given URL.

NSDataReadingOptions

Options for methods used to read data objects.

- initWithContentsOfMappedFile:

Initializes a data object with the contents of the mapped file specified by a given path.

Deprecated
+ dataWithContentsOfMappedFile:

Creates a data object from the mapped file at a given path.

Deprecated

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software