readabilityHandler

var readabilityHandler: ((FileHandle) -> Void)? { get set }

Discussion 議論

The default value of this property is nil. Assigning a valid Block object to this property creates a dispatch source for reading the contents of the file or socket. Your block is submitted to the file handle’s dispatch queue when there is data to read. When reading a file, your handler block is typically executed repeatedly until the entire contents of the file have been read. When reading data from a socket, your handler block is executed whenever there is data on the socket waiting to be read. このプロパティの省略時の値はnilです。有効なBlockオブジェクトをこのプロパティに割り当てることは、ファイルまたはソケットの内容を読み込むことに対するディスパッチソースを作成します。あなたのブロックは、読み込むデータがある場合は、ファイルハンドルの持つディスパッチキューに提出されます。ファイルを読み込む場合、あなたのハンドラブロックはたいてい、ファイルの内容全体が読み込まれてしまうまで繰り返して実行されます。ソケットからデータを読み込む場合、読み込まれるのを待っているデータがソケット上にある時はいつでも、あなたのハンドラブロックは実行されます。

The block you provide must accept a single parameter that is the current file handle. The return type of your block should be void. あなたが提供するブロックは、現在のファイルハンドルであるただ１つのパラメータだけを受け取らなければなりません。あなたのブロックの戻り型は、voidであるべきです。

To stop reading the file or socket, set the value of this property to nil. Doing so cancels the dispatch source and cleans up the file handle’s structures appropriately. ファイルまたはソケットの読み込みを停止するには、このプロパティの値をnilに設定してください。そうすることは、ディスパッチソースを取り消して、ファイルハンドラの持つ構造体を適切に片付けます。