Instance Method インスタンスメソッド

writeData:timeout:completionHandler:

Asynchronously writes the specified data to the stream, and calls a handler upon completion. ストリームへとその指定されたデータを非同期に書き出します、そして完了に関してあるハンドラを呼び出します。

Declaration 宣言 

- (void)writeData:(NSData *)data 
          timeout:(NSTimeInterval)timeout 
completionHandler:(void (^)(NSError *error))completionHandler;

Parameters パラメータ

data

The data to be written. 書き出されるデータ。

timeout

A timeout for writing bytes. If the write is not completed within the specified interval, the write is canceled and the completionHandler is called with an error. Pass 0 to prevent a write from timing out. バイト書き出しのためのダイムアウト。書き出しがその指定された間隔内で完了されないならば、書き出しは取り消されます、そしてcompletionHandlerがあるエラーをつかって呼び出されます。0を渡すことで、書き出しが時間切れになるのを防いでください。

completionHandler

The completion handler to call when all bytes are written, or an error occurs. This handler is executed on the delegate queue. 全てのバイトが書き出される、またはエラーが発生する時に呼び出されることになる完了ハンドラ。このハンドラは、委任先キュー上で遂行されます。

This completion handler takes the following parameter: この完了ハンドラは、以下のパラメータを取ります：

error

An error object that indicates why the write failed, or nil if the write was successful. あるエラーオブジェクト、それはなぜ書き出しが失敗したかを指し示します、またはnil、もし書き出しがうまくいたならば。

Discussion 議論

There is no guarantee that the remote side of the stream has received all of the written bytes at the time that completionHandler is called, only that all of the data has been written to the kernel. ストリームのリモート側が、書き出しバイトの全てを、completionHandlerが呼び出される時に受け取ることは保証されません、データの全てがカーネルに書き出されてしまっているのでなければ。

See Also 参照

Reading and Writing Data データの読み書き

- readDataOfMinLength:maxLength:timeout:completionHandler:
Asynchronously reads a number of bytes from the stream, and calls a handler upon completion. ストリームからあるバイト数を非同期に読み出します、そして完了に関してあるハンドラを呼び出します。