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

movePath:toPath:handler:

Moves the directory or file specified by a given path to a different location in the file system identified by another path. 与えられたパスによって指定されるディレクトリまたはファイルを、別のパスによって識別されるファイルシステムの中の異なる場所に移動します。

Declaration 宣言

- (BOOL)movePath:(NSString *)src 
          toPath:(NSString *)dest 
         handler:(id)handler;

Parameters パラメータ

source: The path of a file or directory to move. source must exist. 移動するファイルまたはディレクトリのパス。sourceは存在しなければなりません。
destination: The path to which source is moved. destination must not yet exist. The destination path must end in a filename; there is no implicit adoption of the source filename. それへとsourceが移動されるパス。destinationは、まだ存在する必要はありません。行き先パスはファイル名で終わらなければなりません；ソースファイル名の暗黙的な選出はありません。
handler: An object that responds to the callback messages fileManager:willProcessPath: and fileManager:shouldProceedAfterError:. You can specify nil for handler; if you do so and an error occurs, the method automatically returns NO. あるオブジェクト、それはコールバックメッセージfileManager:willProcessPath:とfileManager:shouldProceedAfterError:に応答します。あなたは、nilをhandlerに指定できます；あなたがそうするそしてエラーが発生するならば、メソッドは自動的にNOを返します。

Return Value 戻り値

YES if the move operation is successful. If the operation is not successful, but the handler method fileManager:shouldProceedAfterError: returns YES, movePath:toPath:handler: also returns YES; otherwise returns NO. YES、もし移動操作が成功するならば。操作が成功しない、しかしハンドラメソッドfileManager:shouldProceedAfterError:はYESを返すならば、movePath:toPath:handler:もまたYESを返します；そうでなければNOを返します。

Discussion 議論

If source is a file, the method creates a file at destination that holds the exact contents of the original file and then deletes the original file. If source is a directory, movePath:toPath:handler: creates a new directory at destination and recursively populates it with duplicates of the files and directories contained in source. It then deletes the old directory and its contents. Symbolic links are not traversed, however links are preserved. File or directory attributes—that is, metadata such as owner and group numbers, file permissions, and modification date—are also moved. sourceがファイルならば、メソッドはファイルをdestinationで作成します、それは元のファイルの正確な内容を保持します、それから元のファイルを削除します。sourceがディレクトリならば、movePath:toPath:handler:は新しいディレクトリをdestinationで作成します、そして再帰的にそれをsourceの中に含まれるファイルとディレクトリの複製で満たします。それはそのとき古いディレクトリとそれの内容を削除します。シンボリックリンクは辿られません、しかしながらリンクは保全されます。ファイルまたはディレクトリ属性 — すなわち、メタデータ、たとえばオーナーおよびグループ番号、ファイルパーミッション、そして修正日など — もまた移動されます。

The handler callback mechanism is similar to delegation. NSFileManager sends fileManager:willProcessPath: when it begins a copy, move, remove, or link operation. It sends fileManager:shouldProceedAfterError: when it encounters any error in processing. ハンドラコールバックの仕組みは、委任と似ています。NSFileManagerは、fileManager:willProcessPath:をそれがコピー、移動、削除、またはリンク操作を開始する時に送信します。それは、fileManager:shouldProceedAfterError:をそれが何らかのエラーに処理中に遭遇する時に送信します。

If a failure in a move operation occurs, either the preexisting path or the new path remains intact, but not both. 失敗が移動操作において発生するならば、前から存在するパスまたは新しいパスのどちらかが損なわれないままです、しかし両方ではありません。

Special Considerations 特別な注意事項

Because this method does not return error information, it has been deprecated as of OS X v10.5. Use moveItemAtURL:toURL:error: instead. このメソッドがエラー情報を返さないことから、それはOS X v10.5現在で非推奨にされます。moveItemAtURL:toURL:error:を代わりに使ってください。