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

  Name:     stdin() - get string from stdin()
  Usage:    <string> = stdin([<length>])
  Params:   integer <length> - number of characters to get (optional)
  Returns:  string full of characters

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

                 memvar = stdin(10)  && get max 10 chars.
                 memvar = stdin()    && get max 253 chars.

            stdin() waits for user input from the standard console
            device. The input is terminated when a chr(13) is entered.
            The final chr(13) is stripped from the returned string
            and replaced by a null terminator as required by Clipper.
            Note that input from stdin() can be the result of piping
            and redirection. for example, if the first line in your
            Clipper application is:

                 memvar = stdin(50)

            and you start the Clipper application with the following
            command line:

                 MYprog < text.bat

            Where text.bat contains the following text:

                 FUNCky Library <return>

            Then the memvar will be filled with the first line of
            text from text.bat which is "FUNCky Library".

  Note:     You can use redirection to pipe the output of one
            program into another. And if you use the stdout() function,
            you can redirect the output of a Clipper program. Note that
            the maximum line length that stdin() can get is 253 characters.