ファイルからバイト列を読み込む。
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を設定)、そのサイズまでファイルを読み込む。