CBL_READ_SCR_CHARS

Reads a string of characters from the screen.

Syntax:
call "CBL_READ_SCR_CHARS" using     screen-position
                                    character-buffer
                                    string-length
                          returning status-code
Parameters:
Using call prototype (see Library Routines - Key) Picture (32-bit systems)
screen-position Group predefined as cblt-screen-position containing: Group containing:
  cblte-scrp-row   cblt-x1-compx   pic x comp-x.
  cblte-scrp-col   cblt-x1-compx   pic x comp-x.
character-buffer pic x(n). pic x(n).
string-length cblt-x2-compx pic x(2) comp-x.
status-code See Library Routines - Key
On Entry:
screen-position The screen position to start reading at. The top left corner is row 0, column 0. See Screen Routines.
string-length The length of the string to read.
On Exit:
character-buffer The characters read from the screen. This data item must be at least as long as specified by string-length; positions in it beyond that length are unchanged.
string-length If the end of the screen is reached, the length read is returned in here.
See Also: