NSOutputStream

Overview 概要

NSOutputStream is “toll-free bridged” with its Core Foundation counterpart, CFWriteStreamRef. For more information on toll-free bridging, see Toll-Free Bridging. NSOutputStreamは、それのCore Foundation相当物CFWriteStreamRefと「トールフリーブリッジ（通行料無料の橋渡し）」されます。トールフリーブリッジに関する更なる情報としてトールフリーブリッジを見てください。

Subclassing Notes サブクラス作成の注意

NSOutputStream is a concrete subclass of NSStream that lets you write data to a stream. Although NSOutputStream is probably sufficient for most situations requiring this capability, you can create a subclass of NSOutputStream if you want more specialized behavior (for example, you want to record statistics on the data in a stream). NSOutputStreamは、NSStreamの具象サブクラスです、それはあなたにデータをストリームに書き出させます。NSOutputStreamはこの能力を要求するほとんどの状況におそらく十分であるとはいえ、あなたはNSOutputStreamのサブクラスを作成することが、もしあなたがより特殊化された挙動を望む（例えば、あなたがストリームでのデータ上で統計情報を記録したい）ならば可能です。

Methods to Override メソッドのオーバーライド

To create a subclass of NSOutputStream you may have to implement initializers for the type of stream data supported and suitably reimplement existing initializers. You must also provide complete implementations of the following methods: NSOutputStreamのサブクラスを作成するためにあなたは、サポートされるストリームデータのためのイニシャライザを実装、および既存のイニシャライザを適切に再実装しなければならないかもしれません。あなたはまた、以下のメソッドの完全な実装を提供しなければなりません：

• write:maxLength:

  From the current write pointer, take up to the number of bytes specified in the maxLength: parameter from the client-supplied buffer (first parameter) and put them onto the stream. The buffer must be of the size specified by the second parameter. To prepare for the next operation, offset the write pointer by the number of bytes written. Return a signed integer based on the outcome of the current operation: 現在の書き込みポインタから、maxLength:パラメータにおいて指定されるバイト数までクライアント提供のバッファ（最初のパラメータ）から取り上げて、それらをストリームへと置いてください。バッファは、２番目のパラメータによって指定されるサイズのものでなければなりません。次のオペレーションに対して準備するには、書き込みポインタを書き込まれたバイト数で補ってください。符号付き整数を現在のオペレーションの成り行きに基づいて返してください：

  • If the write operation is successful, return the actual number of bytes put onto the stream. 書き込み演算がうまくいくならば、ストリームに置かれた実際のバイト数を返してください。

  • If the stream is of a fixed length and has reached its capacity, return 0. ストリームが固定長のものでそしてそれの容量に届いたならば、0を返してください。

  • If there was an error writing to the stream, return -1. ストリームへの書き込みにエラーがあったならば、-1を返してください。

• hasSpaceAvailable

  Return YES if the stream can currently accept more data, NO if it cannot. If you want to be semantically compatible with NSOutputStream, return YES if a write must be attempted to determine if space is available. YESをストリームが現在さらにデータを受け入れ可能ならば、それができないならばNOを返してください。あなたがNSOutputStreamとの意味論的互換性があることを望むならば、YESをもしある書き込みが空白が利用可能であるかどうかの決定を試みられなければならないならば返してください。