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

removeItemAtPath:error:

Removes the file or directory at the specified path. ファイルとディレクトリを指定されたパスで除去します。

Declaration 宣言

- (BOOL)removeItemAtPath:(NSString *)path 
                   error:(NSError * _Nullable *)error;

Parameters パラメータ

path

A path string indicating the file or directory to remove. If the path specifies a directory, the contents of that directory are recursively removed. You may specify nil for this parameter. 除去されるファイルまたはディレクトリを指し示しているパス文字列。パスがディレクトリを指定するならば、そのディレクトリの内容は再帰的に除去されます。あなたは、このパラメータに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 item was removed successfully or if path was nil. Returns NO if an error occurred. If the delegate stops the operation for a file, this method returns YES. However, if the delegate stops the operation for a directory, this method returns NO. YES、もし項目がうまく除去されたならばまたはpathnilだったならば。エラーが発生したならばNOを返します。委任先が、ファイルに対する操作を停止するならば、このメソッドはYESを返します。委任先が、ディレクトリに対する操作を停止するならば、このメソッドはNOを返します。

Discussion 議論

Prior to removing each item, the file manager asks its delegate if it should actually do so. It does this by calling the fileManager:shouldRemoveItemAtURL: method; if that method is not implemented (or the process is running in OS X 10.5 or earlier) it calls the fileManager:shouldRemoveItemAtPath: method instead. If the delegate method returns YES, or if the delegate does not implement the appropriate methods, the file manager proceeds to remove the file or directory. If there is an error removing an item, the file manager may also call the delegate’s fileManager:shouldProceedAfterError:removingItemAtURL: or fileManager:shouldProceedAfterError:removingItemAtPath: method to determine how to proceed. 各項目を削除するに先だって、ファイルマネージャは、それが実際にそうするべきかそれの委任先に尋ねます。それはこれをfileManager:shouldRemoveItemAtURL:メソッドを呼び出すことによって行います; そのメソッドが実装されていない(またはプロセスがOS X 10.5以前で動作している)ならばそれはfileManager:shouldRemoveItemAtPath:メソッドを代わりに呼び出します。委任先メソッドがYESを返すならば、または委任先が適切なメソッドを実装しないならば、ファイルマネージャがファイルまたはディレクトリの除去を続行します。項目の削除に関してエラーがあるならば、ファイルマネージャはまた委任先の持つfileManager:shouldProceedAfterError:removingItemAtURL:またはfileManager:shouldProceedAfterError:removingItemAtPath:メソッドを呼び出してどのように続けるか決定します。

Removing an item also removes all old versions of that item, invalidating any URLs returned by the URLForPublishingUbiquitousItemAtURL:expirationDate:error: method to old versions. ある項目の除去はその項目の古いバージョンすべても除去します、古いバージョンに対してURLForPublishingUbiquitousItemAtURL:expirationDate:error:メソッドによって返されるあらゆるURLを無効にします。

See Also 参照

Creating and Deleting Items 項目の作成と消去