COBOL2002 ユーザーズガイド


15.2.4 CBLSTMREAD

ファイルからバイト列を読み込みます。

形式
CALL 'CBLSTMREAD' USING 引数1 引数2 引数3 引数4 引数5
規則
  • Windows(x86) COBOL2002の場合,引数1には,ファイルを開いたときに返されたファイルハンドルを4バイトの符号なし2進項目(COMP-X)で指定します。

  • Windows(x64) COBOL2002の場合,引数1には,ファイルを開いたときに返されたファイルハンドルを8バイトの符号なし2進項目(COMP-X)で指定します。

  • 引数2には,読み込む位置を8バイトの符号なし2進項目(COMP-X)で指定します。この値はファイルの先頭を0とした相対位置です。指定できる最大値は2,147,483,135です。ただし,引数4の値が128のときは,この領域に現在のファイルサイズが返されます。

  • 引数3には,読み込むバイト数を4バイトの符号なし2進項目(COMP-X)で指定します。指定できる最大値は65,535です。0を指定した場合は読み込まれません。

  • 引数4には,パラメタを1バイトの符号なし2進項目(COMP-X)で指定します。指定する値は次のとおりです。

    0:標準の読み込み用。

    128:現在のファイルサイズを引数2に指定した領域に返す。このとき,バイト列は読み込まれない。

  • 引数5には,バイト列が読み込まれるバッファを英数字項目で指定します。バッファのサイズは読み込まれるバイト列の格納に十分な大きさを確保しておく必要があります。

注意事項
  • 引数5に指定したバッファのうち,引数3で指定した読み込むバイト数を超える領域は,バイトストリーム入出力サービスルーチンでは更新されません。