画面から文字列を読み取ります。
制約事項: このルーチンはネイティブ COBOL でのみサポートされます。
構文:
call "CBL_READ_SCR_CHARS" using screen-position
character-buffer
string-length
returning status-code
パラメーター
- screen-position
- cblt-screen-position として定義されている集団 (以下を含む)
01 cblt-screen-position typedef.
03 cblte-scrp-row cblt-x1-compx. *> pic x comp-x.
03 cblte-scrp-col cblt-x1-compx. *> pic x comp-x.
- character-buffer
- 呼び出しプロトタイプ (「説明の読み方」を参照):pic x(n)
- PIC:pic x (n)
- string-length
- 呼び出しプロトタイプ (「説明の読み方」を参照):cblt-x2-compx
- PIC:pic x(2) comp-x
- status-code
- 「説明の読み方」を参照。
入力パラメーター:
screen-position |
読み取りを始める画面位置。画面の左上隅が行 0、列 0 になります。「スクリーン ルーチン」を参照してください。 |
string-length |
読み取る文字列の長さ。 |
出力パラメーター:
character-buffer |
画面から読み取った文字。このデータ項目は少なくとも string-length で指定した長さであり、その長さを超えた位置は変更されません。 |
string-length |
画面の末尾に達すると、読み取った長さが返されます。 |