HELP
An object that uses transactions to write
formatted text to a string.

USE
Use To String to created formatted text using
transactions.

If only one string is generated by the To
String transactions, the output container is
a string scalar.  When more than one string
is generated, the output container is an
Array 1D.

WRITE transactions ending with "EOL ON"
will terminate the current output string,
causing the next transaction in the To String
list to write data to the next array element
in the output container.

Write Transactions ending with "EOL OFF"
will not terminate the output string, causing
the characters generated by the next Write
transaction in the To String list to be
appended to the end of the current output
string.  The last transaction in the To
String list will always terminate the output
string, regardless of that transaction's
"EOL" mode.

To String Actions:

* WRITE - Writes data using the specified
encoding and format.

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

To String Encodings:

In almost all cases, you should use TEXT
encoding to write data.

* TEXT - Writes all data types in
human-readable form.  HP VEE numeric data is
automatically converted to text as it is
written.

* BYTE - Converts numeric data to binary form
and writes the ASCII text equivalent that
maps to the least significant byte.  For
example, the following transaction writes the
character A (ASCII 65 decimal):
WRITE BYTE 65

* CASE - Maps an enumerated value or an
integer to a string and writes the string.
For example, you could use CASE to accept
error numbers and write error messages.

LOCATION
I/O ==> To ==> String

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

OBJECT MENU
* Config - Allows you to view and edit
formatting for arrays.

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

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

* Delete Trans - Deletes the currently
highlighted transaction.

EXAMPLE
To String is a useful debug tool to explore
how TEXT transactions operate.  Connect a
Logging AlphaNumeric display to the To String
output terminal to immediately view the
results.

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

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