NSFileManager

Overview 概要

A file manager object lets you examine the contents of the file system and make changes to it. The NSFileManager class provides convenient access to a shared file manager object that is suitable for most types of file-related manipulations. A file manager object is typically your primary mode of interaction with the file system. You use it to locate, create, copy, and move files and directories. You also use it to get information about a file or directory or change some of its attributes. ファイルマネージャオブジェクトは、あなたにファイルシステムの内容を調査させます、そしてそれを変更させます。NSFileManagerクラスは、便利なアクセスを共有ファイルマネージャオブジェクトに対して提供します、それはファイル関連操作のほとんどの型に適します。ファイルマネージャオブジェクトは、一般的にファイルシステムとのやりとりのあなたの主要なモードです。あなたはそれを使って、ファイルとディレクトリの位置を突き止める、作成する、コピーする、そして移動をします。あなたはまた、それを使ってファイルやディレクトリの情報を得たり、それの属性の幾つかを変更します。

When specifying the location of files, you can use either NSURL or NSString objects. The use of the NSURL class is generally preferred for specifying file-system items because URLs can convert path information to a more efficient representation internally. You can also obtain a bookmark from an NSURL object, which is similar to an alias and offers a more sure way of locating the file or directory later. ファイルの位置を指定する場合、あなたはNSURLまたはNSStringオブジェクトのどちらかを使用できます。NSURLクラスは、さまざまなファイルシステム項目を指定するのに一般的に好まれます、なぜならURLそれらはパス情報をもっと効率の良い表現に内部的に変換できるからです。あなたはまた、NSURLオブジェクトからブックマークを得ることができます、それはエイリアスに似ています、そして後でファイルやディレクトリの位置決めをするいっそう確実な方法を提供します。

If you are moving, copying, linking, or removing files or directories, you can use a delegate in conjunction with a file manager object to manage those operations. The delegate’s role is to affirm the operation and to decide whether to proceed when errors occur. In macOS 10.7 and later, the delegate must conform to the NSFileManagerDelegate protocol. あなたがファイルやディレクトリの移動、コピー、リンク、または削除をしようとするならば、あなたはある委任先をファイルマネージャオブジェクトと連係して使用してそれら操作を管理できます。委任先の持つ役割は、操作を肯定すること、そしてエラーが発生した場合に続けるかどうかを決めることです。macOS 10.7以降では、委任先はNSFileManagerDelegateプロトコルに準拠しなければなりません。

In iOS 5.0 and later and in macOS 10.7 and later, NSFileManager includes methods for managing items stored in iCloud. Files and directories tagged for cloud storage are synced to iCloud so that they can be made available to the user’s iOS devices and Macintosh computers. Changes to an item in one location are propagated to all other locations to ensure the items stay in sync. iOS 5.0以降とmacOS 10.7以降では、NSFileManagerはiCloudに格納されるアイテムの管理のためのメソッドを含みます。クラウドストレージに対するタグをつけられるファイルとディレクトリは、iCloudと同期します、それでそれらはユーザの持つiOSデバイスとMacintoshコンピュータに利用可能にされます。ある場所でアイテムに加えられる変更は、全ての他の場所に伝えられて、アイテムが同期されたままであるのを保証します。

Threading Considerations スレッドの考察

The methods of the shared NSFileManager object can be called from multiple threads safely. However, if you use a delegate to receive notifications about the status of move, copy, remove, and link operations, you should create a unique instance of the file manager object, assign your delegate to that object, and use that file manager to initiate your operations. 共有NSFileManagerオブジェクトのメソッドは、複数のスレッドから安全に呼び出されることができます。しかしながら、あなたが移動、コピー、除去、そしてリンク操作の状況についての通知を受け取るのに委任先を使うならば、あなたはファイルマネージャオブジェクトのある固有のインスタンスを作成して、そのオブジェクトにあなたの委任先の役を割り当てて、そしてそのファイルマネージャを使ってあなたの操作を開始するべきです。