差分

このページの2つのバージョン間の差分を表示します。

--- translation:working:翻訳5 [2016-05-09 23:17]
Decomo
+++ translation:working:翻訳5 [2016-08-24 13:46] (現在)
Decomo
@@ 行 104: / 行 104: @@
 パラメータは''FSEventStreamCallback''データ型のリファレンスマニュアルで解説しています。
-Your event handler receives three lists: a list of paths, a list of identifiers, and a list of flags. In effect, these represent a list of events. The first event consists of the first entry taken from each of the arrays, and so on. Your handler must iterate through these lists, processing the events as needed.
+イベントハンドラは、パス、識別子、フラグの3つのリストを受け取ります。
+実質的に、これらがイベントのリストを表します。
+The first event consists of the first entry taken from each of the arrays, and so on.
+イベント処理の必要に応じて、ハンドラはこれらリストをイテレートして下さい。
-For each event, you should scan the directory at the specified path, processing its contents as desired. Normally, you need to scan only the exact directory specified by the path. However, there are three situations in which this is not the case:
+For each event, you should scan the directory at the specified path, processing its contents as desired.
+通常、そのパスによって示されるディレクトリだけを走査する必要があります。しかしながら、そのケースに当てはまらない3つの状況があります:
-    If an event in a directory occurs at about the same time as one or more events in a subdirectory of that directory, the events may be coalesced into a single event. In this case, you will receive an event with the kFSEventStreamEventFlagMustScanSubDirs flag set. When you receive such an event, you must recursively rescan the path listed in the event. The additional changes are not necessarily in an immediate child of the listed path.
+  * １つのディレクトリにおいて、サブディレクトリ内で複数のイベントが同時に発生した場合、それらイベントは1つのイベントにまとめられる可能性があります。このケースでは、''kFSEventStreamEventFlagMustScanSubDirs''フラグが立ったイベントを受信することになります。このようなイベントを受信した時は、そのイベントに載っているパスを再帰的に再走査すべきです。変化の追加分は、必ずしもリストアップされたパスの直接の子供にあるとは限りません。
+  * カーネルとユーザー空間の間でコミュニケーションエラーが発生した場合、''kFSEventStreamEventFlagKernelDropped''か''kFSEventStreamEventFlagUserDropped''フラグが立ったイベントを受け取ることになるでしょう。このケースでは、監視中の全てのディレクトリをフルスキャンしなければなりません。なぜならば、何が変更されたかを決める一切の手立てがないからです。
-    If a communication error occurs between the kernel and the user-space daemon, you may receive an event with either the kFSEventStreamEventFlagKernelDropped or kFSEventStreamEventFlagUserDropped flag set. In either case, you must do a full scan of any directories that you are monitoring because there is no way to determine what may have changed.
+<note>
+イベントのドロップ時は''kFSEventStreamEventFlagMustScanSubDirs''フラグも同様にセットされます。
+上で述べたように、パスのフルスキャンを行うべきかどうかの判断では、
     Note: When an event is dropped, the kFSEventStreamEventFlagMustScanSubDirs flag is also set. Thus, it is not necessary to explicitly check for the dropped event flags when determining whether to perform a full rescan of a path. The dropped event flags are provided purely for informational purposes.