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

removeItem(at:)

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

Declaration 宣言

func removeItem(at URL: URL) throws

Parameters パラメータ

URL

A file URL specifying the file or directory to remove. If the URL specifies a directory, the contents of that directory are recursively removed. 除去するファイルまたはディレクトリを指定しているファイルURL。URLがディレクトリを指定するならば、そのディレクトリの内容は再帰的に除去されます。

Return Value 戻り値

true if the item was removed successfully or if URL was nil. Returns false if an error occurred. If the delegate stops the operation for a file, this method returns true. However, if the delegate stops the operation for a directory, this method returns false. true、もし項目がうまく除去されたならばまたはURLnilだったならば。エラーが発生したならばfalseを返します。委任先が、ファイルに対する操作を停止するならば、このメソッドはtrueを返します。委任先が、ディレクトリに対する操作を停止するならば、このメソッドはfalseを返します。

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(_:shouldRemoveItemAt:) 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 true, 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:removingItemAt:) or fileManager(_:shouldProceedAfterError:removingItemAtPath:) method to determine how to proceed. 各項目を削除するに先だって、ファイルマネージャは、それが実際にそうするべきかそれの委任先に尋ねます。それはこれをfileManager(_:shouldRemoveItemAt:)メソッドを呼び出すことによって行います; そのメソッドが実装されていない(またはプロセスがOS X 10.5以前で動作している)ならばそれはfileManager(_:shouldRemoveItemAtPath:)メソッドを代わりに呼び出します。委任先メソッドがtrueを返すならば、または委任先が適切なメソッドを実装しないならば、ファイルマネージャがファイルまたはディレクトリの除去を続行します。項目の削除に関してエラーがあるならば、ファイルマネージャはまた委任先の持つfileManager(_:shouldProceedAfterError:removingItemAt:)またはfileManager(_:shouldProceedAfterError:removingItemAtPath:)メソッドを呼び出してどのように続けるか決定します。

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

See Also 参照

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