CBL_READ

構文：

call "CBL_READ_FILE" using file-handle
                           file-offset
                           byte-count
                           flags
                           buffer

パラメーター：

	呼び出しプロトタイプ使用時 (「説明の読み方」を参照)	PIC
`file-handle`	cblt-bytestream-handle	pic x(4) comp-5
`file-offset`	cblt-x8-compx	pic x(8) comp-x
`byte-count`	cblt-x4-compx	pic x(4) comp-x
`flags`	cblt-x1-compx	pic x comp-x
`buffer`	pic x(`n`)	pic x(`n`)

入力パラメーター：

file-handle

ファイルを開いた際に返されるファイルハンドル。

file-offset

読み込みを行うファイル内のオフセット。このフィールドは、最大値が x"00FFFFFFFF" に制限されている。ただし、CBL_OPEN_FILE または CBL_CREATE_FILE を使用してファイルを開いた際にビット 4 のアクセスモードフラグが設定される場合を除く。

byte-count

読み込むバイト数。

flags

このパラメーターは、次の値を取ることができる。

0	標準の読み取り
128	`file-offset` の現在のファイルサイズを返す

出力パラメーター：

file-offset: flags が入力時に 128 に設定されている場合は、戻り値として現在のファイルサイズが含まれる。
buffer: バイトの読み取り先のバッファー。バッファーが、読み取り対象のバイト数を格納できる大きさであるかを確認する必要がある。

説明：

呼び出しが成功したかどうかは、RETURN-CODE を確認してチェックできる。

このルーチンを使用して、.lbr ファイルに格納されているファイルを読み取る場合は、ファイルの終わり状態は返されない。必要なファイルのみを読み取るには、最初にファイルのサイズを取得して (flags を 128 に設定)、そのサイズまでを読み取る。