Click above to get retro games delivered to your door ever month!

  Name:     readscreen() - read character strings off the screen
  Usage:    <string> = readscreen(<row>,<col>,<length>)
  Params:   integer <row> - the row to start reading at
            integer <col> - the column to start reading at
            integer <length> - the number of characters to read

  Returns:  a string of <length> length filled with the characters
            that were being displayed starting at the location defined
            by the <row>, <col> coordinates.

 ---------------------------------- Example ---------------------------------

                 print(10,0,"This is on the screen")
                 tempstr = readscreen(10,0,7)
                 ? tempstr
                 * prints "This is"

  Note:     Readscreen() reads characters off the page currently
            being displayed unless you declare a new virtual
            screen or window with the setscreen() function.

  Warning!: If you specify to read characters passed the end of
            the video screen (coords 24,79 in 80 column mode), you
            will end up with garbage characters in your string.