Input function (LotusScript® Language)

Reads a sequence of characters from a sequential or binary file into a string variable, without interpreting the input.


Input[$] ( count , [#]fileNumber )



The number of characters to read.


The number assigned to the file when you opened it.

Return value

The Input function returns a Variant, and Input$ returns a String.

LotusScript® returns the specified number of characters, beginning at the current position in the file.

If you request more characters than are available, LotusScript® generates an error.

If count is 0, LotusScript® returns the empty string ("").


The input data is not filtered or translated in any way. All characters are returned, including newline characters, quotation marks, and spaces.

If you want to work with bytes instead of characters, use the InputB or InputB$ function.

You cannot use the Input, Input$, InputB, or InputB$ functions to read a file opened in Output, Append, or Random mode.