NSInputStream

@interface NSInputStream : NSStream

Overview 概要

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

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

NSInputStream is an abstract superclass of a class cluster consisting of concrete subclasses of NSStream that provide standard read-only access to stream data. Although NSInputStream is probably sufficient for most situations requiring access to stream data, you can create a subclass of NSInputStream if you want more specialized behavior (for example, you want to record statistics on the data in a stream). NSInputStreamは、NSStreamの具象サブクラスいくらかからなるクラスクラスタの抽象スーパークラスで、それは標準的読み出し専用アクセスをストリームデータに提供します。NSInputStreamはストリームデータへのアクセスを要求するほとんどの状況におそらく十分であるとはいえ、あなたはNSInputStreamのサブクラスを作成することが、もしあなたがより特殊化された挙動を望む（例えば、あなたがストリームでのデータ上で統計情報を記録したい）ならば可能です。

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

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

• read:maxLength:

  From the current read index, take up to the number of bytes specified in the second parameter from the stream and place them in the client-supplied buffer (first parameter). The buffer must be of the size specified by the second parameter. Return the actual number of bytes placed in the buffer; if there is nothing left in the stream, return 0. Reset the index into the stream for the next read operation. 現在の読み出しインデックスから、２番目のパラメータにおいて指定されるバイト数までストリームから取り上げて、それらをクライアントに提供されるバッファ（第１パラメータ）の中に置きます。バッファは、２番目のパラメータによって指定されるサイズのものでなければなりません。バッファに置かれる実際のバイト数を返してください；ストリームに残されるものがないならば、0を返してください。ストリームへのインデックスを次の読み出し操作のために再設定してください。

• getBuffer:length:

  Return in 0(1) a pointer to the subclass-allocated buffer (first parameter). Return by reference in the second parameter the number of bytes actually put into the buffer. The buffer’s contents are valid only until the next stream operation. Return NO if you cannot access data in the buffer; otherwise, return YES. If this method is not appropriate for your type of stream, you may return NO. 0(1) においてサブクラスアロケートのバッファへにポインタを返してください。２番目のパラメータにおいて参照によって実際にバッファの中に置かれるバイト数を返してください。バッファの内容は、ただ次のストリーム操作まで有効なだけです。NOを返してください、もしあなたがバッファの中のデータにアクセスできないならば；そうでなければ、YESを返してください。このメソッドがあなたのストリームの型に適さないならば、あなたはNOを返すかもしれません。

• hasBytesAvailable

  Return YES if there is more data to read in the stream, NO if there is not. If you want to be semantically compatible with NSInputStream, return YES if a read must be attempted to determine if bytes are available. YESをもっとデータがストリームにおいて読み出すためにあるならば、ないならばNOを返してください。あなたがNSInputStreamと意味論の互換性があってほしいならば、YESをバイトが利用可能か決定するために読み出しが試みられなければならないならば返してください。