Say

Writes a record to a terminal, a file or a port.

Format:

SPECTRA> say text_expr

Description:

The text_expr is written to the terminal.

/so$*$cket

Communicates via an open socket. See the example in section 15.3.49.

/cls

The screen is cleared before the text is displayed.

/esc

The text will be preceded by the escape character (ASCII 27).

/fptr[=ptr_symbol]

The record is written to a file that has been opened by a C fopen statement. The default name of the symbol that stores the file pointer is file_ptr. An example can be found in section 15.3.32.

/mai$*$lto[=email.address]

A string is sent as an email to the specified address. The default address is the user name. This feature is intended to be used from automatic on-line applications. A .gra file may detect some error and use this command to inform the user.

/rest$*$ore_cursor

The cursor position is saved, the text is written to the terminal and the original cursor position is restored.

/exp_log

The text is written to online.log unless this command is executed in an Online client session. In this case the command is passed to the server. The client has no open log-files. This applies also for output to /online_dir/online.log.

/exp_syslog

The text is written to /online_dir/online.log.

/exp_log/time

The text is written to online.log with a time stamp.

/exp_log/motors

The motor positions are written to online.log.

/li$*$ne=nl

The text is written to line number nl.