# recvln

Receives characters of a line.

    recvln

## Remarks

Retrieves a line of received characters from the host and stores it in the system variable "inputstr".
This command waits until a line is received or the communication between Tera Term and the host is terminated or the timeout occurs.

If the system variable "timeout" or "mtimeout" is greater than zero, the timeout occurs when <timeout>.<mtimeout> seconds have passed. If the timeout is less than or equal to zero, the timeout never occurs.

If the line is received successfully, the system variable "result" is set to 1. Otherwise, "result" is set to zero.

## Example

    ; open the log file
    fileopen file 'log.txt' 0
    ; enter synchronous mode
    setsync 1
    result=1

    while result=1
      ; receive one line
      recvln
      ; write it to the log file
      filewriteln file inputstr
    endwhile

    ; enter asynchronous mode
    setsync 0

See also "setsync" for the synchronous mode.