linkItem(at:to:)

func linkItem(at srcURL: URL, 
           to dstURL: URL) throws

Return Value 戻り値

true if the hard link was created or false if an error occurred. This method also returns false if a file, directory, or link already exists at dstURL. ハードリンクが作成されたならばtrueまたはエラーが発生したならばfalse。このメソッドはまたfalseを、ファイル、ディレクトリ、またはリンクが既にdstURLで存在するならば返します。

Discussion 議論

Use this method to create hard links between files in the current file system. If srcURL is a directory, this method creates a new directory at dstURL and then creates hard links for the items in that directory. If srcURL is (or contains) a symbolic link, the symbolic link is copied and not converted to a hard link at dstURL. このメソッドを使ってハードリンクをファイル間に現在のファイルシステムにおいて作成してください。srcPathがディレクトリならば、このメソッドは新しいディレクトリをdstURLで作成して、それからハードリンクをそのディレクトリの中の項目に対して作成します。srcURLが（または含まれるものが）シンボリックリンクならば、そのシンボリックリンクがコピーされ、dstURLでハードリンクに変換されません。

Prior to linking each item, the file manager asks its delegate if it should actually create the link. It does this by calling the fileManager(_:shouldLinkItemAt:to:) method; if that method is not implemented it calls the fileManager(_:shouldLinkItemAtPath:toPath:) method instead. If the delegate method returns true, or if the delegate does not implement the appropriate methods, the file manager creates the hard link. If there is an error linking one out of several items, the file manager may also call the delegate’s fileManager(_:shouldProceedAfterError:linkingItemAt:to:) or fileManager(_:shouldProceedAfterError:linkingItemAtPath:toPath:) method to determine how to proceed. 各項目をリンクするに先だって、ファイルマネージャは、それが実際にリンクを作成するべきかそれの委任先に尋ねます。それはこれをfileManager(_:shouldLinkItemAt:to:)メソッドを呼び出すことによって行います； そのメソッドが実装されていないならばそれはfileManager(_:shouldLinkItemAtPath:toPath:)メソッドを代わりに呼び出します。委任先メソッドがtrueを返すならば、または委任先が適切なメソッドを実装しないならば、ファイルマネージャはハードリンクを作成します。項目のコピーに関してエラーがあるならば、ファイルマネージャはまた委任先の持つfileManager(_:shouldProceedAfterError:linkingItemAt:to:)またはfileManager(_:shouldProceedAfterError:linkingItemAtPath:toPath:)メソッドを呼び出してどのように続けるか決定します。