Instance Method


Recursively rereads the entire contents of a file wrapper from the specified location on disk.


- (BOOL)readFromURL:(NSURL *)url options:(NSFileWrapperReadingOptions)options error:(NSError * _Nullable *)outError;



URL of the file-system node corresponding to the file wrapper.


Option flags for reading the node located at url. See NSFileWrapperReadingOptions for possible values.


If an error occurs, upon return contains an NSError object that describes the problem. Pass NULL if you do not want error information.

Return Value

YES if successful. If not successful, returns NO after setting outError to an NSError object that describes the reason why the file wrapper could not be reread.


When reading a directory, children are added and removed as necessary to match the file system.

See Also

Updating File Wrappers

- needsToBeUpdatedFromPath:

Indicates whether the file wrapper needs to be updated to match a given file-system node.

- matchesContentsOfURL:

Indicates whether the contents of a file wrapper matches a directory, regular file, or symbolic link on disk.

- updateFromPath:

Updates the file wrapper to match a given file-system node.


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