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

removeFileAtPath:handler:

Deletes the file, link, or directory (including, recursively, all subdirectories, files, and links in the directory) identified by a given path. 与えられたパスによって識別されるファイル、リンク、またはディレクトリを（再帰的にそのディレクトリの中の全ての下位ディレクトリ、ファイル、そしてリンクを含めて）消去します。

Declaration 宣言 

- (BOOL)removeFileAtPath:(NSString *)path 
                 handler:(id)handler;

Parameters パラメータ

path

The path of a file, link, or directory to delete. The value must not be "." or "..". 削除するファイル、リンク、またはディレクトリのパス。値は、"." または ".." であってはなりません。

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 deletion stops and the method automatically returns NO. あるオブジェクト、それはコールバックメッセージfileManager:willProcessPath:とfileManager:shouldProceedAfterError:に応答します。あなたは、nilをhandlerに指定できます；あなたがそうするそしてエラーが発生するならば、削除は停止します、そしてメソッドは自動的にNOを返します。

Return Value 戻り値

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

Discussion 議論

This callback mechanism provided by handler 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. handlerによって提供されるこのコールバックの仕組みは、委任と似ています。NSFileManagerは、fileManager:willProcessPath:をそれがコピー、移動、削除、またはリンク操作を開始する時に送信します。それは、fileManager:shouldProceedAfterError:をそれが何らかのエラーに処理中に遭遇する時に送信します。

Since the removal of directory contents is so thorough and final, be careful when using this method. If you specify "." or ".." for path an NSInvalidArgumentException exception is raised. This method does not traverse symbolic links. ディレクトリ内容の除去は非常に徹底的で最終的であることから、このメソッドを使っている場合は注意してください。あなたが "." または ".." をpathに指定するならばNSInvalidArgumentException例外が引き起こされます。このメソッドは、シンボリックリンクを辿りません。

Special Considerations 特別な注意事項

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

See Also 参照

Deprecated Methods 非推奨メソッド

- copyPath:toPath:handler:
Copies the directory or file specified in a given path to a different location in the file system identified by another path. 与えられたパスの中の指定されたディレクトリまたはファイルを別のパスによって識別されるファイルシステムの中の異なる場所へとコピーします。
Deprecated 非推奨
- 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. 与えられたパスによって指定されるディレクトリまたはファイルを、別のパスによって識別されるファイルシステムの中の異なる場所に移動します。
Deprecated 非推奨
- changeFileAttributes:atPath:
Changes the attributes of a given file or directory. 与えられたファイルまたはディレクトリの属性を変更します。
Deprecated 非推奨
- fileAttributesAtPath:traverseLink:
Returns a dictionary that describes the POSIX attributes of the file specified at a given. 与えられるところで指定されたファイルのPOSIX属性を記述する辞書を返します。
Deprecated 非推奨
- fileSystemAttributesAtPath:
Returns a dictionary that describes the attributes of the mounted file system on which a given path resides. そこにおいて与えられたパスが存在するところのマウントされたファイルシステムの属性を記述する辞書を返します。
Deprecated 非推奨
- directoryContentsAtPath:
Returns the directories and files (including symbolic links) contained in a given directory. 与えられたディレクトリの中に含まれる（シンボリックリンクを含む）ディレクトリとファイルを返します。
Deprecated 非推奨
- createDirectoryAtPath:attributes:
Creates a directory (without contents) at a given path with given attributes. ディレクトリを（内容無しで）与えられたパスで、いくらかの与えられた属性とともに作成します。
Deprecated 非推奨
- createSymbolicLinkAtPath:pathContent:
Creates a symbolic link identified by a given path that refers to a given location. 与えられたパスによって識別されるシンボリックリンクを作成します、それは与えられた場所に言及します。
Deprecated 非推奨
- pathContentOfSymbolicLinkAtPath:
Returns the path of the directory or file that a symbolic link at a given path refers to. 与えられたパスでのシンボリックリンクが参照するディレクトリまたはファイルのパスを返します。
Deprecated 非推奨
- linkPath:toPath:handler:
Creates a link from a source to a destination. リンクをソースから行き先まで作成します。
Deprecated 非推奨
- fileManager:shouldProceedAfterError:
An NSFileManager object sends this message to its handler for each error it encounters when copying, moving, removing, or linking files or directories. ファイルまたはディレクトリをコピー、移動、削除、またはリンクする場合にそれが出くわす各エラーに対するそれのハンドラにこのメッセージを送ったNSFileManagerオブジェクト。
Deprecated 非推奨
- fileManager:willProcessPath:
An NSFileManager object sends this message to a handler immediately before attempting to move, copy, rename, or delete, or before attempting to link to a given path. 移動、コピー、名前変更、または消去を試みる直前に、または与えられたパスにリンクを試みる前にハンドラにこのメッセージを送ったNSFileManagerオブジェクト。
Deprecated 非推奨

Related Documentation 関連文書

- linkItemAtURL:toURL:error:
Creates a hard link between the items at the specified URLs. 指定されたURLでの項目それらの間のハードリンクを作成します。
- moveItemAtPath:toPath:error:
Moves the file or directory at the specified path to a new location synchronously. 指定されたパスでファイルやディレクトリを新しい場所に同期的に移動します。
- copyItemAtPath:toPath:error:
Copies the item at the specified path to a new location synchronously. 指定されたパスでファイルを新しい場所に同期的にコピーします。
- removeItemAtPath:error:
Removes the file or directory at the specified path. ファイルとディレクトリを指定されたパスで除去します。