duplicate(_:completionHandler:)

Duplicates the specified URLS asynchronously in the same manner as the Finder.

Declaration

func duplicate(_ URLs: [URL], completionHandler handler: (@Sendable ([URL : URL], (any Error)?) -> Void)? = nil)

func duplicate(_ URLs: [URL]) async throws -> [URL : URL]

URLs:
An array of Nsurl objects representing the files to duplicate. This parameter must not be nil.
handler:
The completion handler block object to call when the operation completes. You may specify nil for this parameter. If this parameter is not nil, you must call the Duplicate(_:completionhandler:) method from a block running on an active dispatch queue; your completion handler block is subsequently executed on the same dispatch queue.
This block takes two parameters:
newURLs
A dictionary parameter whose keys and values are Nsurl objects. Each key is a URL from the URLs parameter. The value of each key is a URL representing the location of the duplicated file. If this method could not duplicate a file, the corresponding URL is not included in the dictionary.
error
If the operation succeeded for every file, this parameter is nil. If the operation failed for one or more files, the parameter contains an error object describing the overall result of the operation in a manner suitable for presentation to the user.

This method may cause a progress indicator, or other user interface element, to be shown by the Finder.

In macOS 10.6, this method requires the app to run its main run loop in a common mode. You can safely call this method from any thread of your app.