Input stream

The input stream in CAOS is a stream from which data can be read off by commands. It is typically used to read data from the filesystem.

Once the input stream is opened data is available on it. This is then read off, with the data no longer accessible on the stream after it has been read. The input stream should then be closed.

The input stream is closed automatically when directed to another file, when the virtual machine is destroyed, or when the engine exits.

The following commands open or add to the input stream:
 * FILE IOPE opens a file to it,
 * FILE GLOB reads a directory to it.

The following commands read from the input stream:
 * INOK checks if it is readable,
 * INNI and INNF read off integers and floats,
 * INNL reads off a line.

FILE ICLO closes the input stream.