CBL_READ_SCR_CHATTRS

Reads a string of characters and their attributes from the screen.

Syntax:
call "CBL_READ_SCR_CHATTRS"  using    screen-position
                                      character-buffer
                                      attribute-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).
attribute-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.
attribute-buffer The attributes 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 (in cells, that is, character-attribute pairs) is returned in here.
See Also: