Instance Method インスタンスメソッド

linkItemAtURL:toURL:error:

Creates a hard link between the items at the specified URLs. 指定されたURLでの項目それらの間のハードリンクを作成します。

Declaration 宣言

- (BOOL)linkItemAtURL:(NSURL *)srcURL 
                toURL:(NSURL *)dstURL 
                error:(NSError * _Nullable *)error;

Parameters パラメータ

srcURL

The file URL that identifies the source of the link. The URL in this parameter must not be a file reference URL; it must specify the actual path to the item. The value in this parameter must not be nil. リンクの出所を識別するファイルURL。このパラメータの中のURLは、ファイル参照URLであってはいけません;それは項目への実際のパスを指定しなければなりません。このパラメータの中の値は、nilであってはいけません。

dstURL

The file URL that specifies where you want to create the hard link. The URL in this parameter must not be a file reference URL; it must specify the actual path to the item. The value in this parameter must not be nil. ファイルURL、それはあなたがハードリンクを作成することを望むのはどこかを指定します。このパラメータの中のURLは、ファイル参照URLであってはいけません;それは項目への実際のパスを指定しなければなりません。このパラメータの中の値は、nilであってはいけません。

error

On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information. 入力では、エラーオブジェクトへのポインタ。エラーが発生するならば、このポインタはエラー情報を含んでいる実際のエラーオブジェクトへと設定されます。あなたは、nilをこのパラメータに対して指定するかもしれません、もしあなたがエラー情報を望まないならば。

Return Value 戻り値

YES if the hard link was created or NO if an error occurred. This method also returns NO if a file, directory, or link already exists at dstURL. ハードリンクが作成されたならばYESまたはエラーが発生したならばNO。このメソッドはまたNOを、ファイル、ディレクトリ、またはリンクが既に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:shouldLinkItemAtURL:toURL: method; if that method is not implemented it calls the fileManager:shouldLinkItemAtPath:toPath: method instead. If the delegate method returns YES, 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:linkingItemAtURL:toURL: or fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: method to determine how to proceed. 各項目をリンクするに先だって、ファイルマネージャは、それが実際にリンクを作成するべきかそれの委任先に尋ねます。それはこれをfileManager:shouldLinkItemAtURL:toURL:メソッドを呼び出すことによって行います; そのメソッドが実装されていないならばそれはfileManager:shouldLinkItemAtPath:toPath:メソッドを代わりに呼び出します。委任先メソッドがYESを返すならば、または委任先が適切なメソッドを実装しないならば、ファイルマネージャはハードリンクを作成します。項目のコピーに関してエラーがあるならば、ファイルマネージャはまた委任先の持つfileManager:shouldProceedAfterError:linkingItemAtURL:toURL:またはfileManager:shouldProceedAfterError:linkingItemAtPath:toPath:メソッドを呼び出してどのように続けるか決定します。

See Also 参照

Creating Symbolic and Hard Links シンボリックおよびハードリンクを作成する