Imports a document into the same location as an existing document.
- iOS 11.0+
- Mac Catalyst 13.0+
The URL of the document's initial location.
The URL of a document that is already managed by a file provider (the local file provider, the iCloud file provider, or a third-party file provider). The system imports the document into the same file provider and directory as this URL.
The mode used when importing the document. For a list of import modes, see
Browser Import Mode
The URL of the newly imported document, or
nilif an error occurred.
An object that describes the error, if one occurred; otherwise, it is set to
Use this method to import a document into the same file provider and directory as an existing document.
For example, to duplicate a document that's already managed by a file provider:
Create a duplicate of the original file in the user's temporary directory. Be sure to give it a unique name.
import, passing in the temporary file's URL as the
Document At URL: next To Document At URL: mode: completion Handler:
documentparameter and the original file's URL as the
The system imports the duplicate into the same file provider (the local file provider, the iCloud file provider, or a third-party file provider) and the same directory as the original file.