Gambas Documentation - /lang/lineinput

# LINE INPUT

LINE INPUT [ # Stream , ] Variable

Reads an entire line of text from the text stream Stream into a String Variable.

If the stream Stream is not specified, then the standard input is used.

The entire line is read, except the end-of-line delimiter.

The end-of-line delimiter can be defined with the Stream.EndOfLine property. It is gb.Unix by default, which selects a single `Chr$(10)` character.

Do not use this instruction to read from binary files, because you will lose the linefeed characters. Use READ instead.

Do not use this instruction inside the Read event of a process that does not necessarily send a newline (because it is printing a prompt for example). It will block forever waiting for the newline character.

### Examples

    DIM hFile AS Stream
    DIM sOneLine AS String

    ' Print a file to standard output
    hFile = OPEN "/etc/hosts" FOR INPUT

    WHILE NOT Eof(hFile)
      LINE INPUT #hFile, sOneLine
      PRINT sOneLine
    WEND

    CLOSE #hFile

### See also

- Stream & Input/Output functions

- Stream.EndOfLine

- Stream.EndOfFile