ファイルからバイト列を読み込む。
call "CBL_READ_FILE" using file-handle file-offset byte-count flags buffer
| 呼び出しプロトタイプ使用時 ( 説明の読み方) | PIC (32 ビット システム) | |
|---|---|---|
| file-handle | cblt-x4-compx | pic x(4). | 
| 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"に制限されている。 | ||||
| byte-count | 読み込むバイト数。本項目は現在最大値x "00FFFF"に制限されている。 | ||||
| flags | P>本パラメーターは次の値を取る。 
 | 
| file-offset | flagsパラメーターが入口上で128に設定されていると、戻される現ファイルサイズが入る。 | 
| buffer | バイトカラムが読み込まれるバッファー。利用者の責任において、読み込まれるバイト数に足るバッファーサイズを確保すること。 | 
呼び出しが成功したか否かは、RETURN-CODEを調べるて確認する。
.lbr fileに含まれているファイルを読み込むために本ルーチンを使用する場合には、ファイル終了状態が返される。
目的のファイルを確実に読み込むには、まずファイルサイズを取り出し(flagsに128を設定)、そのサイズまでファイルを読み込む。