importDocument(at:nextToDocumentAt:mode:completionHandler:)
Imports a document into the same location as an existing document.
Declaration
func importDocument(at documentURL: URL, nextToDocumentAt neighbourURL: URL, mode importMode: UIDocumentBrowserViewController.ImportMode, completionHandler completion: @escaping (URL?, (any Error)?) -> Void)func importDocument(at documentURL: URL, nextToDocumentAt neighbourURL: URL, mode importMode: UIDocumentBrowserViewController.ImportMode) async throws -> URLParameters
- documentURL:
The URL of the document’s initial location.
- neighbourURL:
The URL of a document that’s 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.
- importMode:
The mode used when importing the document. For a list of import modes, see Importmode.
- completion:
- importedDocumentURL
The URL of the newly imported document, or
nilif an error occurs.- error
An object that describes the error, if one occurred; otherwise, it’s set to
nil.
Discussion
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.
Call importDocument(at:nextToDocumentAt:mode:completionHandler:), passing in the temporary file’s URL as the
documentURLparameter and the original file’s URL as theneighbourURLparameter.
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.