cancel()

Discussion 議論

Use this method to cancel any active calls to coordinate the reading or writing of a file. If the block passed to the file coordination call has not yet been executed—perhaps because the file coordinator is still waiting for a response from other file presenters—the file coordinator method stops waiting for a response, does not execute its block, and returns an error object with the error code NSUserCancelledError. However, if the block is already being executed, the file coordinator method does not return until the block finishes executing. このメソッドを使って何らかの現行の呼び出しをキャンセルすることで、あるファイルの読み出しまたは書き込みを調整して（協調させて）ください。ファイル協調呼び出しに渡されるブロックがまだ実行されていないならば — おそらくファイルコーディネータがまだ他のファイルプレゼンタからの応答に対して待機しているため — ファイルコーディネータメソッドは応答に対する待機を止めて、それのブロックを実行せず、そしてエラーオブジェクトをエラーコードNSUserCancelledErrorと共に返します。しかしながら、ブロックがすでに実行されているならば、ファイルコーディネータメソッドはブロックが実行をし終わるまで返りません。

You can call this method from any thread of your application and it returns immediately without waiting for the file coordinator object to respond. Thus, when this method returns, you cannot assume that the read or write operation occurred or did not occur. (In fact, it is possible for this method to return while the file coordinator is in the middle of executing a block.) If you want to know whether the operation actually occurred, you must track it yourself by setting a flag when the block starts executing or by using some other means. あなたはこのメソッドを、あなたのアプリケーションのどんなスレッドからも呼び出すことができます。そしてそれはファイルコーディネータオブジェクトが応答するのを待機することなしに直ぐに返ります。したがって、このメソッドが返る時に、あなたは読み出しまたは書き込み演算が発生したまたは発生しなかったことを仮定できません。（事実、このメソッドには、ファイルコーディネータがブロックの実行の途中である間に返ることが可能です。）あなたが演算が実際に発生したかどうか知りたいならば、あなたはそれをあなた自身で追跡することを、ブロックが実行を始める時にあるフラグを設定することによってまたは何らかの他の手段によってしなければなりません。