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

copyItem(atPath:toPath:)

Copies the item at the specified path to a new location synchronously. 指定されたパスでファイルを新しい場所に同期的にコピーします。

Declaration 宣言

func copyItem(atPath srcPath: String, 
       toPath dstPath: String) throws

Parameters パラメータ

srcPath

The path to the file or directory you want to move. This parameter must not be nil. あなたが移動することを望むファイルまたはディレクトリへのパス。このパラメータは、nilであってはいけません。

dstPath

The path at which to place the copy of srcPath. This path must include the name of the file or directory in its new location. This parameter must not be nil. そこにsrcPathのコピーを置くことになるパス。このパスは、ファイルまたはディレクトリのそれの新しい場所における名前を含まなければなりません。このパラメータは、nilであってはいけません。

Return Value 戻り値

true if the item was copied successfully or the file manager’s delegate stopped the operation deliberately. Returns false if an error occurred. 項目がうまくコピーされたならば、またはファイルマネージャの持つ委任先が操作を故意に停止したならばtrue。エラーが発生したならばfalseを返します。

Discussion 議論

When copying items, the current process must have permission to read the file or directory at srcPath and write the parent directory of dstPath. If the item at srcPath is a directory, this method copies the directory and all of its contents, including any hidden files. If a file with the same name already exists at dstPath, this method stops the copy attempt and returns an appropriate error. If the last component of srcPath is a symbolic link, only the link is copied to the new path. 項目をコピーする場合、現在のプロセスはsrcPathでのファイルまたはディレクトリを読み込む、そしてdstPathの親ディレクトリに書き出す権限を持たなければなりません。srcPathでの項目がディレクトリならば、このメソッドはそのディレクトリとそれの内容の全てをコピーします、あらゆる不可視ファイルを含めて。同じ名前を持つファイルが既にdstPathで存在するならば、このメソッドはコピーの試みを停止して、適切なエラーを返します。srcPathの最後の構成要素がシンボリックリンクならば、そのリンクだけが新しいパスにコピーされます。

Prior to copying an item, the file manager asks its delegate if it should actually do so for each item. It does this by calling the fileManager(_:shouldCopyItemAt:to:) method; if that method is not implemented it calls the fileManager(_:shouldCopyItemAtPath:toPath:) method instead. If the delegate method returns true, or if the delegate does not implement the appropriate methods, the file manager copies the given file or directory. If there is an error copying an item, the file manager may also call the delegate’s fileManager(_:shouldProceedAfterError:copyingItemAt:to:) or fileManager(_:shouldProceedAfterError:copyingItemAtPath:toPath:) method to determine how to proceed. ある項目をコピーするに先だって、ファイルマネージャは、それが各項目に対して実際にそうするべきかそれの委任先に尋ねます。それはこれをfileManager(_:shouldCopyItemAt:to:)メソッドを呼び出すことによって行います; そのメソッドが実装されていないならばそれはfileManager(_:shouldCopyItemAtPath:toPath:)メソッドを代わりに呼び出します。委任先メソッドがtrueを返すならば、または委任先が適切なメソッドを実装しないならば、ファイルマネージャは与えられたファイルまたはディレクトリをコピーします。項目のコピーに関してエラーがあるならば、ファイルマネージャはまた委任先の持つfileManager(_:shouldProceedAfterError:copyingItemAt:to:)またはfileManager(_:shouldProceedAfterError:copyingItemAtPath:toPath:)メソッドを呼び出してどのように続けるか決定します。

See Also 参照

Moving and Copying Items 項目の移動とコピー