Discussion
議論
You use this method to perform read-related operations on a file or directory in a coordinated manner. This method executes synchronously, blocking the current thread until the reader
block finishes executing. Before executing that block, though, the file coordinator waits until other relevant file presenter objects finish in-progress actions. Similarly, your read operation may cause pending actions for other file presenters to wait until your operations are complete. Whether or not the file coordinator waits depends on whether the item being read is a file or a directory and also depends on other related operations.
あなたはこのメソッドを使って、読み出し関連演算をファイルまたはディレクトリ上で協調的流儀で実行します。このメソッドは同期的に実行します、現在のスレッドをreader
ブロックが実行を終えるまでブロックします。そのブロックの実行前に、ファイルコーディネータは、他の関連ファイルプレゼンタオブジェクトが現在進行中のアクションを終えるまで待機します。同様に、あなたの読み出し演算は、他のファイルプレゼンタにとっての懸案の動作があなたの演算が完了するまで待機することを引き起こすかもしれません。ファイルコーディタが待機するかどうかは、読み出されている項目が、ファイルかディレクトリかに依存します、そしてまた他の関連演算に依存します。
When invoking these methods, declare a __block
variable before the accessor block and initialize it to a value that signals failure, and then inside the accessor block set it to a value that indicates success. If the coordinated operation fails, then the accessor block never runs. The sentinel variable still holds a value that indicates failure, and the NSError
out parameter contains a reference that describes the error.
これらのメソッドを発動する場合、__block
変数をアクセッサブロックの前に宣言してそれを失敗を合図するある値に初期化してください、それからアクセッサブロックの内部でそれを成功を指し示すある値に設定してください。協調演算が失敗するならば、そのときアクセッサブロックは決して実行されません。この見張りの変数は、依然として失敗を指し示すある値を保持します、そしてNSError
outパラメータは、エラーを記述するある参照を含みます。
This method calls the relinquishPresentedItem(toReader:)
method of any relevant file presenters. This method is called for file presenters in the current process and in other processes. Depending on the options you specify, other methods of the file presenters may also be called. When reading a file package directory, file presenter objects that are currently reading the contents of that file package also receive these notifications. All of the called methods must return successfully before the file coordinator executes your block. If multiple file presenters are operating on the item, the order in which those presenters are notified is undefined.
このメソッドは、あらゆる関連するファイルプレゼンタそれらのrelinquishPresentedItem(toReader:)
メソッドを呼び出します。このメソッドは、現在のプロセスにおいてそして他のプロセスにおいてそれらファイルプレゼンタを呼び出します。あなたが指定するオプションに依存して、それらファイルプレゼンタの他のメソッドもまた呼び出されるかもしれません。ファイルパッケージディレクトリを読み出している場合、現在そのファイルパッケージの内容を読みだしているファイルプレゼンタオブジェクトもまた、これらの通知を受け取ります。呼び出されたメソッドの全ては、ファイルコーディネータがあなたのブロックを実行する前に、うまく返らなければなりません。複数のファイルプレゼンタがその項目上で演算を行っているならば、それらプレゼンタが通知を受ける順番は未定義です。
If the device has not yet downloaded the file at the given URL, this method blocks (potentially for a long time) while the file is downloaded. If the file cannot be downloaded, this method fails. Alternatively; use a metadata query to check for the NSMetadataUbiquitousItemDownloadingStatusKey
key, and then call the startDownloadingUbiquitousItem(at:)
method to download the file before trying to read it.
デバイスが与えられたURLでのファイルをまだダウンロードし終わっていないならば、このメソッドは、そのファイルがダウンロードされる間は、遮断します(もしかすると長い間)。ファイルがダウンロードされることができないならば、このメソッドは失敗します。代わりとして;あるメタデータクエリをNSMetadataUbiquitousItemDownloadingStatusKey
キーを調べるために使ってください、そしてそれからstartDownloadingUbiquitousItem(at:)
メソッドを呼び出してそのファイルのダウンロードをそれの読み出しを試みる前に行ってください。
If you want to perform a write operation from inside a read block, use the coordinate(writingItemAt:options:writingItemAt:options:error:byAccessor:)
method.
あなたが書き込み演算を読み出しブロック内から実行したいならば、coordinate(writingItemAt:options:writingItemAt:options:error:byAccessor:)
メソッドを使ってください。
If you want to perform a batch read operation on multiple files, use the prepare(forReadingItemsAt:options:writingItemsAt:options:error:byAccessor:)
method instead.
あなたがバッチ読み出し演算を複数のファイル上で実行したいならば、prepare(forReadingItemsAt:options:writingItemsAt:options:error:byAccessor:)
メソッドを代わりに使ってください。