Instance Method


Returns a dictionary of file attributes to associate with the document file when writing or updating it.


func fileAttributesToWrite(to url: URL, for saveOperation: UIDocumentSaveOperation) throws -> [AnyHashable : Any]



A file URL locating the document in the application sandbox.


A constant that indicates whether the document file is being written the first time or whether it is being overwritten. See UIDocumentSaveOperation for details.


If you override this method and cannot write the document data for any reason, return by indirection an NSError object that encapsulates the reasons why you can’t. Otherwise, ignore this parameter.

Return Value

A dictionary of file attributes—for example, level of file protection and creation date. See FileManager for more information about file attributes.


The attributes are associated with a specific file type and save operation. You can override this method to return a dictionary of file attributes that are different than the default file attribute, which for new files is extensionHidden.

The save(to:for:completionHandler:) calls this method before executing asynchronous writing. It passes the dictionary into writeContents(_:andAttributes:safelyTo:for:) when it calls that method to write the document file.

See Also

Related Symbols

func fileNameExtension(forType: String?, saveOperation: UIDocumentSaveOperation)

Returns a file extension to append to the file URL of the document file being written.