13.31 Streamクラス
Stream
を使用してストリーム・データ(通常はLONG
)を読取りまたは書込みします。
-
読取り可能な
Stream
を使用して、結果セットからのストリーム・データの取得、またはストアド・プロシージャ・コールからのOUT
バインド変数の取得を行います。読取り可能なStream
は、最後のデータに達するまで完全に読み取るか、または、不要なデータを破棄するためにクローズする必要があります。 -
書込み可能な
Stream
は、ストリーム・データ(通常はLONG
)を、コール可能文を含むパラメータ化された文に提供するために使用されます。
表13-45 Streamクラスで使用される列挙値
属性 | オプション |
---|---|
Status |
|
表13-46 Streamメソッドの概要
メソッド | 概要 |
---|---|
ストリームを読み取り、Streamオブジェクトから読み取ったデータ量を戻します。 |
|
ストリームから最後のバッファを読み取ります。 |
|
バッファからストリームにデータを書き込みます。 |
|
バッファからストリームに最後のデータを書き込みます。 |
|
ストリームの現在のステータスを戻します。 |
13.31.1 readBuffer()
Stream
からデータを読み取ります。sizeパラメータには読み取るバイト文字の最大数を指定します。Stream
オブジェクトから読み取ったデータ量を戻します。-1はストリームのデータの終了を意味します。
構文
virtual int readBuffer( char *buffer, unsigned int size) = 0;
パラメータ | 説明 |
---|---|
buffer |
データ・バッファのポインタを指定します。ポインタは、コール元で割当ておよび解放する必要があります。 |
size |
読み取るバイト数を指定します。 |
13.31.2 readLastBuffer()
Stream
から最後のバッファを読み取ります。読み取らないデータを廃棄するためにコールすることもできます。sizeパラメータには読み取るバイト文字の最大数を指定します。Stream
オブジェクトから読み取ったデータ量を戻します。-1
はストリームのデータの終了を意味します。
構文
virtual int readLastBuffer( char *buffer, unsigned int size) = 0;
パラメータ | 説明 |
---|---|
buffer |
データ・バッファのポインタを指定します。ポインタは、コール元で割当ておよび解放する必要があります。 |
size |
読み取るバイト数を指定します。 |
13.31.3 writeBuffer()
バッファからストリームにデータを書き込みます。データ量は、サイズ
によって決まります。
構文
virtual void writeBuffer( char *buffer, unsigned int size) = 0;
パラメータ | 説明 |
---|---|
buffer |
データ・バッファへのポインタを指定します。 |
size |
書き込む |
13.31.4 writeLastBuffer()
このメソッドは、バッファからストリームに最後のデータを書き込みます。データの最後のチャンクを書き込むためにコールすることもできます。書き込まれるデータ量は、サイズによって決まります。
構文
virtual void writeLastBuffer( char *buffer, unsigned int size) = 0;
パラメータ | 説明 |
---|---|
buffer |
データ・バッファへのポインタを指定します。 |
size |
書き込むバイト数を指定します。 |