HELP
An object that reads data from the operating
system standard input using transactions.

USE
Use StdIn object to read a wide variety of
file encodings and formats from the standard
input of HP VEE.

All From StdIn objects use the same read
pointer, even if they are in different
threads or different contexts.  This means
that data read by one From StdIn object is
not re-read by another From StdIn object.

To place data in HP VEE's standard in
pipe, you can either type lines in the shell
window where the HP VEE process was started
or start the HP VEE process using a pipe
command to redirect standard input.  For
example,
cat someFileName | veetest

sends the contents of file someFileName
into HP VEE's standard input.

To read all of the data from standard
input until standard input is closed use a
READ ...  ARRAY TO END:  transaction.

From StdIn Actions:

* READ - Reads data using the specified
encoding and format.

* WAIT - Waits the specified number of
seconds before executing the next
transaction.

From StdIn Encodings:

* TEXT - Reads all data types from an
ASCII-data stream.

* BINARY - Reads all data types from an
machine-specific binary format.

* BINBLOCK - Reads all HP VEE data types from
binary data files with IEEE 488.2 definite
length block headers.

* CONTAINER - Reads all data types from an HP
VEE specific text format.

To help prevent a READ transaction from
hanging until data is available on stdin, use
a READ IOSTATUS DATA READY transaction in a
separate From StdIn object.  This transaction
returns a 1 if there is at least one byte to
read, and a 0 if there are no bytes to read.

LOCATION
I/O ==> From ==> StdIn

OPEN VIEW PARAMETERS
The open view shows the list of transactions
to be executed.

OBJECT MENU

* Add Trans - Adds a transaction to the end
of the list.

* Insert Trans - Inserts a transaction before
the currently highlighted transaction.

* Cut Trans - Cuts (deletes) the currently
highlighted transaction, but saves it in the
transaction "cut-and-paste" buffer.

* Copy Trans - Copies the currently
highlighted transaction to the transaction
"cut-and-paste" buffer.

* Paste Trans - Pastes a transaction,
previously "cut" or "copied" to the buffer,
in the position before the currently
highlighted transaction.

SHORT CUTS
To quickly insert a transaction, place the
cursor on a transaction.  Press [CTRL-O] to
insert a transaction over the transaction
where you placed the cursor.

To quickly delete ("kill") a transaction,
place the cursor on that transaction and
press [CTRL-K].

To paste a transaction from the "kill"
buffer press [CTRL-Y].

To quickly move to the next or previous
transaction, press [CTRL-N] or [CTRL-P]
respectively.

SEE ALSO
From File, To StdOut, and To/From Named Pipe.

"Using Transaction I/O" in Using HP VEE,
chapter 12.
